ICurrencyCache
Der Dienst ICurrencyCache bietet zwischengespeicherten Zugriff auf das transactioncurrency Set der Organisation plus die Basiswährung der Organisation. Währungen werden beim ersten Zugriff als einziger Schnappschuss geladen und in einem groben Schiebefenster aktualisiert – Administratoren fügen selten neue Währungen hinzu, sodass der Cache einen kleinen Speicherbedarf eintauscht, um Währungssuchen pro Datensatz auf dem Hot-Record-Retrieve-Pfad zu eliminieren.
Automatische Bestandsaufnahme in den Unterlagen
Du musst normalerweise nicht direkt berühren ICurrencyCache . Immer wenn der Abruf eines Datensatzes mindestens eine Geldspalte enthält, projiziert transactioncurrencyid der Server automatisch und hängt die aufgelöste Währung an die Currency Eigenschaft des Datensatzes an. MoneyEdit Konsumiert diese Karte, um das korrekte Symbol in seiner Startverzierung darzustellen.
Direkter Zugang
Für benutzerdefinierten serverseitigen Code, der eine Währung nach id nachschlagen, jede Währung in der Organisation aufzählen muss (einen Währungspicker, eine Wechselkursanzeige) oder die Basiswährung auflösen muss, injizieren ICurrencyCacheSie :
Tipp
ICurrencyCacheist nur serverseitig. Browserseitiger Code, der die Währung der Zeile benötigt,TableRecord.Currencyliest sich direkt (Blazor) /record.currency(React) – wird automatisch ausgefüllt, wenn der Datensatz eine Geldspalte enthält.
ICurrencyCache Interface
Methoden
Name | Parameter | Typ | Beschreibung |
|---|---|---|---|
Get | Guid id | Currency? | Gibt die Währung mit der gegebenen |
GetAll | IReadOnlyDictionary<Guid, Currency> | Es gibt jede in der Organisation konfigurierte Währung zurück, die nach id verschlüsselt ist. Als Single geladen Schnappschuss — Aufrufer, die das Wörterbuch iterieren, sehen keine teilweisen Aktualisierungen, wenn die Der Cache wird mitten in der Aufzählung aktualisiert. | |
GetAllAsync | CancellationToken token | Task<IReadOnlyDictionary<Guid, Currency>> | Asynchron gibt jede in der Organisation konfigurierte Währung zurück, die nach id eingeschlüsselt ist. |
GetAsync | Guid id CancellationToken token | Task<Currency> | Asynchron gibt die Währung mit der angegebenen |
GetBaseCurrency | Currency? | Die Grundwährung der Organisation, gelöst von | |
GetBaseCurrencyAsync | CancellationToken token | Task<Currency> | Asynchron gibt die Grundwährung der Organisation zurück. |
Name:
GetParameter:
Guid id
Typ:
Currency?
Beschreibung:
Gibt die Währung mit der gegebenen Transaktionswährungid zurück, oder null , wenn kein passender Datensatz in Dataverse existiert.
Name:
GetAllTyp:
IReadOnlyDictionary<Guid, Currency>
Beschreibung:
Es gibt jede in der Organisation konfigurierte Währung zurück, die nach id verschlüsselt ist. Als Single geladen Schnappschuss — Aufrufer, die das Wörterbuch iterieren, sehen keine teilweisen Aktualisierungen, wenn die Der Cache wird mitten in der Aufzählung aktualisiert.
Name:
GetAllAsyncParameter:
CancellationToken token
Typ:
Task<IReadOnlyDictionary<Guid, Currency>>
Beschreibung:
Asynchron gibt jede in der Organisation konfigurierte Währung zurück, die nach id eingeschlüsselt ist.
Name:
GetAsyncParameter:
Guid id
CancellationToken token
CancellationToken token
Typ:
Task<Currency>
Beschreibung:
Asynchron gibt die Währung mit der angegebenen transaktionscurrencyid zurück, oder null , wenn kein passender Datensatz existiert.
Name:
GetBaseCurrencyTyp:
Currency?
Beschreibung:
Die Grundwährung der Organisation, gelöst von organization.basecurrencyid . Als Rückfallplan für Datensätze verwendet, deren transaktionscurrencyid null ist — Typisch für Tische, die überhaupt nicht an Multi-Currency teilnehmen. Rückkehren null , wenn der Organisationsdatensatz nicht aufgelöst werden kann (was auch der Fall wäre. ein tieferes Dataverse-Konnektivitätsproblem anzeigen).
Name:
GetBaseCurrencyAsyncParameter:
CancellationToken token
Typ:
Task<Currency>
Beschreibung:
Asynchron gibt die Grundwährung der Organisation zurück.
Currency Baureihe
Eigenschaften
Name | Typ | Default | Beschreibung |
|---|---|---|---|
ExchangeRate | decimal | 1 | Wechselkurs gegen die Basiswährung der Organisation, aus dem |
IsoCode | string | Der ISO 4217 dreibuchstabige Code (z. B. | |
Name | string | Der lokalisierte Währungsname von | |
Precision | int | 2 | Dezimalstellen zum Anzeigen, bezogen aus MoneyMetadata.Precision, was die Säulengenauigkeit ist; Das ist der Währungsstandard. |
Symbol | string | Das Anzeigesymbol, das Dataverse im |
Name:
ExchangeRateTyp:
decimal
Default:
1
Beschreibung:
Wechselkurs gegen die Basiswährung der Organisation, aus dem Wechselkurs . 1.0 für die Grundwährung selbst. Surfaced hauptsächlich für Diagnostik / fortgeschrittene Anzeige Szenarien — Redakteure führen die Konvertierung nicht lokal durch.
Name:
IsoCodeTyp:
string
Beschreibung:
Der ISO 4217 dreibuchstabige Code (z. B. USD, EUR, JPY). Lesen Sie aus isocurrencycode . Nützlich für ARIA-Bezeichnungen und kulturbewusste Formatierungsrückfälle.
Name:
NameTyp:
string
Beschreibung:
Der lokalisierte Währungsname von currencyname (z. B. US-Dollar ). Benutzt in Pickern, Tooltips und Barrierefreiheitstexten.
Name:
PrecisionTyp:
int
Default:
2
Beschreibung:
Dezimalstellen zum Anzeigen, bezogen aus currencyprecision . Fällt auf 2 zurück wenn Dataverse das Feld null lässt. Unabhängig von
MoneyMetadata.Precision, was die Säulengenauigkeit ist; Das ist der Währungsstandard.Name:
SymbolTyp:
string
Beschreibung:
Das Anzeigesymbol, das Dataverse im Währungssymbol speichert – bis zu 5 Zeichen, typischerweise ein einzelnes Unicode-Glyphe ($ , € , £ , ¥ ), aber gelegentlich eine kurze Kette für Währungen, die keine Einzelglyphenform haben (Fr , kr , R$ ) oder organisationsspezifische benutzerdefinierte Werte. Wortwörtlich wiedergegeben im Editor – Unicode + Font Fallback deckt jede Glyphe ab; kein SVG-Seitenwagen.