Valores de visualización

Bloques de construcción de solo lectura para páginas de registro: una insignia de estado, una dirección postal y una forma de leer el valor de una columna en código sin descifrar el formato de la transferencia.

Leer el valor de una columna

Para hacer una ramificación en un valor (tinte un estado, mostrar una bandera, comparar una fecha), lee el valor bruto de la columna en lugar de su etiqueta, que está localizada. En React, useColumnValue(columnName) devuelve el valor de una columna del entorno RecordContext como un tipo JavaScript simple, con la cadena formateada y los metadatos de la columna junto a él. En Blazor, lee el valor tipado del registro con GetValueOrDefault<T>. En cualquier caso, una columna que está vacía o que está retenida por la seguridad de la columna se lee como null; CanReadColumn distingue ambas cosas.

React Blazor

Fuera de un RecordContext, como en un renderizador de celda de cuadrícula o en una descripción introductoria de gráficos, llama readColumnRawValue(record, columnName) desde @powerportalspro/core el registro que posees.

Insignia de estatus

ColumnStatusBadge muestra la razón de estado del disco (statuscode) y toma su color del estado (statecode): un tinte de marca mientras está activo, un contorno neutro en caso contrario. El color proviene del valor del estado, no de su etiqueta, por lo que se cumple en todos los idiomas. Nada se renderiza cuando la etiqueta está vacía o retenida.

Ejemplo de reacción Ejemplo de Blazor React TypeScript Razor
Contoso Ltd Active
Fabrikam, Inc. Inactive

Tonos personalizados

Para una tabla con más de dos estados, pasa una Tone función que asigne el valor del estado a un color y apariencia de insignia. Recibe null cuando el estado está vacío o retenido.

React Blazor

Dirección

AddressDisplayValue muestra una de las direcciones de una tabla (address1, address2, ...) en un <address> elemento, con la misma etiqueta que ColumnDisplayValue. Muestra la columna de _composite Dataverse cuando el usuario puede leerla. De lo contrario, compone las líneas de calles, luego ciudad, región y código postal, y después el país, que omite cuando coincide HomeCountrycon .

Ejemplo de reacción Ejemplo de Blazor React TypeScript Razor
1 Microsoft Way
Building 92
Redmond, WA 98052
70 Wilson Street
London, EC2A 2DB
United Kingdom
Reaccionar Blazor

ColumnStatusBadge Clase

Parámetros

Nombre
Tipo
Default
Descripción
IsVisiblebool
True
¿Se ve la placa?
LabelColumnstring
statuscode
Columna cuyo valor formateado es el texto de la insignia. Por defecto a statuscode, el estado razón; usar código de estado para una tabla cuya razón de estado no sea legible.
SizeBadgeSize?
Tamaño de la placa. Por defecto es el de Fluent.
StateColumnstring
statecode
Columna cuyo valor decide el tono. Por defecto es el código de estado.
ToneFunc<int?, StatusBadgeTone>?
Elige el tono del valor de la columna de estado — null cuando está vacío o retenido. Por defecto a StatusBadgeTone.Default(System.Nullable{System.Int32}): un tinte de marca para activo (0), un esquema neutro en caso contrario. Suministra uno para una tabla con más de dos estados.
Nombre: IsVisible
Tipo: bool
Default: True
Descripción: ¿Se ve la placa?
Nombre: LabelColumn
Tipo: string
Default: statuscode
Descripción: Columna cuyo valor formateado es el texto de la insignia. Por defecto a statuscode, el estado razón; usar código de estado para una tabla cuya razón de estado no sea legible.
Nombre: Size
Tipo: BadgeSize?
Descripción: Tamaño de la placa. Por defecto es el de Fluent.
Nombre: StateColumn
Tipo: string
Default: statecode
Descripción: Columna cuyo valor decide el tono. Por defecto es el código de estado.
Nombre: Tone
Tipo: Func<int?, StatusBadgeTone>?
Descripción: Elige el tono del valor de la columna de estado — null cuando está vacío o retenido. Por defecto a StatusBadgeTone.Default(System.Nullable{System.Int32}): un tinte de marca para activo (0), un esquema neutro en caso contrario. Suministra uno para una tabla con más de dos estados.
Reaccionar Blazor

AddressDisplayValue Clase

Parámetros

Nombre
Tipo
Default
Descripción
Descriptionstring?
La descripción se mostrará en la descripción introductiva. Vuelve al {Prefijo}_composite Descripción de la columna.
DisplayLabelWhenAvailablebool
True
Especifica si mostrar una etiqueta si está disponible.
DisplayTooltipWhenAvailablebool
True
Especifica si mostrar una descripción emergente si está disponible.
EmptyPlaceholderstring
—
Texto mostrado cuando la dirección está vacía. Por defecto se muestra un guion em; pasa una cadena vacía a Suprimir.
HomeCountrystring?
El país para dejar fuera una dirección compuesta, por ejemplo, 'Estados Unidos' para un portal cuyo Las direcciones son casi todas domésticas. Comparado ignorando el caso y los acentos. No se aplica cuando la dirección es el propio compuesto de Dataverse, que se muestra al formatearla.
IsVisiblebool
True
¿Es visible la dirección?
Labelstring?
Texto que se mostrará como etiqueta. Vuelve a la etiqueta de la columna {Prefijo}_composite , por ejemplo, 'Dirección 1'.
Prefixstring
address1
El prefijo de columna de la dirección — address1, address2 o una dirección personalizada prefijo. Las partes se leen de {Prefijo}_line1... 3, _city, _stateorprovince, _postalcode, _country y _composite. Por defecto se pone a address1.
Nombre: Description
Tipo: string?
Descripción: La descripción se mostrará en la descripción introductiva. Vuelve al {Prefijo}_composite Descripción de la columna.
Nombre: DisplayLabelWhenAvailable
Tipo: bool
Default: True
Descripción: Especifica si mostrar una etiqueta si está disponible.
Nombre: DisplayTooltipWhenAvailable
Tipo: bool
Default: True
Descripción: Especifica si mostrar una descripción emergente si está disponible.
Nombre: EmptyPlaceholder
Tipo: string
Default: —
Descripción: Texto mostrado cuando la dirección está vacía. Por defecto se muestra un guion em; pasa una cadena vacía a Suprimir.
Nombre: HomeCountry
Tipo: string?
Descripción: El país para dejar fuera una dirección compuesta, por ejemplo, 'Estados Unidos' para un portal cuyo Las direcciones son casi todas domésticas. Comparado ignorando el caso y los acentos. No se aplica cuando la dirección es el propio compuesto de Dataverse, que se muestra al formatearla.
Nombre: IsVisible
Tipo: bool
Default: True
Descripción: ¿Es visible la dirección?
Nombre: Label
Tipo: string?
Descripción: Texto que se mostrará como etiqueta. Vuelve a la etiqueta de la columna {Prefijo}_composite , por ejemplo, 'Dirección 1'.
Nombre: Prefix
Tipo: string
Default: address1
Descripción: El prefijo de columna de la dirección — address1, address2 o una dirección personalizada prefijo. Las partes se leen de {Prefijo}_line1... 3, _city, _stateorprovince, _postalcode, _country y _composite. Por defecto se pone a address1.