ICurrencyCache
El ICurrencyCache servicio proporciona acceso en caché al conjunto de transactioncurrency la organización más la moneda base de la organización. Las monedas se cargan como una única instantánea en el primer acceso y se actualizan en una ventana deslizante gruesa — los administradores rara vez añaden nuevas monedas, por lo que la caché intercambia una pequeña huella de memoria por eliminar las consultas por registro en la ruta caliente de recuperación de registros.
Población automática en registros
Normalmente no necesitas tocar ICurrencyCache directamente. Siempre que el fetch de un registro incluye al menos una columna de dinero, el servidor proyecta transactioncurrencyid automáticamente y adjunta la moneda resuelta a la propiedad del Currency registro. MoneyEdit La consume para mostrar el símbolo correcto en su adorno inicial.
Acceso directo
Para código personalizado del lado del servidor que necesita buscar una moneda por id, enumerar todas las monedas de la organización (un selector de divisas, una visualización de tipos de cambio), o resolver la moneda base, inyecta ICurrencyCache:
Propina
ICurrencyCachees solo del lado del servidor. El código del navegador que necesita la moneda de la fila seTableRecord.Currencylee (Blazor) /record.currency(React) directamente — se llena automáticamente cuando el registro lleva una columna de dinero.
ICurrencyCache Interface
Métodos
Nombre | Parámetros | Tipo | Descripción |
|---|---|---|---|
Get | Guid id | Currency? | Devuelve la moneda con el |
GetAll | IReadOnlyDictionary<Guid, Currency> | Devuelve todas las monedas configuradas en la organización, claveadas por id. Cargado como un solo instantánea — los llamantes que iteran el diccionario no verán actualizaciones parciales si el La caché se actualiza a mitad de la enumeración. | |
GetAllAsync | CancellationToken token | Task<IReadOnlyDictionary<Guid, Currency>> | Devuelve asíncronamente todas las monedas configuradas en la organización, claveadas por id. |
GetAsync | Guid id CancellationToken token | Task<Currency> | Devuelve asíncronamente la moneda con el |
GetBaseCurrency | Currency? | La moneda base de la organización, resuelta desde | |
GetBaseCurrencyAsync | CancellationToken token | Task<Currency> | Devuelve de forma asincrónica la moneda base de la organización. |
Nombre:
GetParámetros:
Guid id
Tipo:
Currency?
Descripción:
Devuelve la moneda con el transactioncurrencyid indicado, o null cuando no existe ningún registro coincidente en Dataverse.
Nombre:
GetAllTipo:
IReadOnlyDictionary<Guid, Currency>
Descripción:
Devuelve todas las monedas configuradas en la organización, claveadas por id. Cargado como un solo instantánea — los llamantes que iteran el diccionario no verán actualizaciones parciales si el La caché se actualiza a mitad de la enumeración.
Nombre:
GetAllAsyncParámetros:
CancellationToken token
Tipo:
Task<IReadOnlyDictionary<Guid, Currency>>
Descripción:
Devuelve asíncronamente todas las monedas configuradas en la organización, claveadas por id.
Nombre:
GetAsyncParámetros:
Guid id
CancellationToken token
CancellationToken token
Tipo:
Task<Currency>
Descripción:
Devuelve asíncronamente la moneda con el transactioncurrencyid dado, o nulo cuando no existe ningún registro coincidente.
Nombre:
GetBaseCurrencyTipo:
Currency?
Descripción:
La moneda base de la organización, resuelta desde organization.basecurrencyid . Usado como respaldo para registros cuyo transactioncurrencyid es nulo — Es típico en mesas que no participan en la multimoneda en absoluto. Retornos nulo si el registro de organización no puede resolverse (lo cual también sería indican un problema de conectividad más profundo con Dataverse).
Nombre:
GetBaseCurrencyAsyncParámetros:
CancellationToken token
Tipo:
Task<Currency>
Descripción:
Devuelve de forma asincrónica la moneda base de la organización.
Currency Clase
Propiedades
Nombre | Tipo | Default | Descripción |
|---|---|---|---|
ExchangeRate | decimal | 1 | Tipo de cambio frente a la moneda base de la organización, desde |
IsoCode | string | El código ISO 4217 de tres letras (por ejemplo, | |
Name | string | El nombre de la moneda local proviene | |
Precision | int | 2 | Decimales para mostrar, obtenidos de MoneyMetadata.Precision, que es la precisión a nivel de columna; Este es el impago a nivel de moneda. |
Symbol | string | El símbolo de visualización que Dataverse almacena en |
Nombre:
ExchangeRateTipo:
decimal
Default:
1
Descripción:
Tipo de cambio frente a la moneda base de la organización, desde el tipo de cambio . 1.0 para la propia moneda base. Superficie principalmente para diagnóstico / visualización avanzada Escenarios — Los editores no realizan conversiones localmente.
Nombre:
IsoCodeTipo:
string
Descripción:
El código ISO 4217 de tres letras (por ejemplo, USD , EUR , JPY ). Leído de isocurrencycode . Útil para etiquetas ARIA y soluciones de formato conscientes de la cultura.
Nombre:
NameTipo:
string
Descripción:
El nombre de la moneda local proviene del nombre de moneda (por ejemplo, Dólar estadounidense ). Usados En selectores, descripciones emergentes y texto de accesibilidad.
Nombre:
PrecisionTipo:
int
Default:
2
Descripción:
Decimales para mostrar, obtenidos de currencyprecision . Vuelve a ser 2 cuando Dataverse deja el campo nulo. Independientemente de
MoneyMetadata.Precision, que es la precisión a nivel de columna; Este es el impago a nivel de moneda.Nombre:
SymbolTipo:
string
Descripción:
El símbolo de visualización que Dataverse almacena en el símbolo de moneda — hasta 5 caracteres, típicamente un solo glifo Unicode ($ , € , £ , ¥ ) pero ocasionalmente una cadena corta para monedas que carecen de forma de glifo único (Fr , kr , R$ ) o valores personalizados específicos de cada organización. Traducido literalmente en el editor — Unicode + fuente de respaldo cubre todos los glifos; No hay sidecar SVG.