Valores de Exibição

Blocos de construção somente leitura para páginas de registro: um crachá de status, um endereço postal e uma forma de ler o valor de uma coluna em código sem decodificar o formato da linha.

Lendo o valor de uma coluna

Para ramificar em um valor (tintar um status, mostrar uma flag, comparar uma data), leia o valor bruto da coluna em vez do rótulo, que é localizado. No React, useColumnValue(columnName) retorna o valor de uma coluna do circundante RecordContext como um tipo JavaScript simples, com a string formatada e os metadados da coluna ao lado. No Blazor, leia o valor digitado do registro com GetValueOrDefault<T>. De qualquer forma, uma coluna que está vazia ou retida pela segurança da coluna se lê como null; CanReadColumn distingue os dois.

React Blazor

Fora de um RecordContext, como em um renderizador de grade ou em uma dica de gráfico, chame readColumnRawValue(record, columnName) de @powerportalspro/core sobre o registro que você mantém.

Distintivo de status

ColumnStatusBadge mostra a razão de status do disco (statuscode) e toma sua cor do estado (statecode): um tom de marca enquanto ativo, um contorno neutro caso contrário. A cor vem do valor do estado, não do rótulo, então ela vale em todos os idiomas. Nada é renderizado quando o rótulo está vazio ou retido.

Exemplo de reação Exemplo de Blazor React TypeScript Razor
Contoso Ltd Active
Fabrikam, Inc. Inactive

Tons personalizados

Para uma tabela com mais de dois estados, passe uma Tone função que mapeie o valor do estado para uma cor e aparência do distintivo. Ela recebe null quando o estado está vazio ou retido.

React Blazor

Endereço

AddressDisplayValue renderiza um dos endereços de uma tabela (address1, address2, ...) em um <address> elemento, com o mesmo rótulo de ColumnDisplayValue. Ele mostra a coluna do _composite Dataverse quando o usuário pode lê-la. Caso contrário, ele compõe as linhas das ruas, depois cidade, região e código postal, e depois o país, que omite quando corresponde HomeCountrya .

Exemplo de reação Exemplo de Blazor React TypeScript Razor
1 Microsoft Way
Building 92
Redmond, WA 98052
70 Wilson Street
London, EC2A 2DB
United Kingdom
React Blazor

ColumnStatusBadge Classe

Parâmetros

Nome
Tipo
Padrão
Descrição
IsVisiblebool
True
O distintivo é visível?
LabelColumnstring
statuscode
Coluna cujo valor formatado é o texto do distintivo. Padrão para statuscode, o status razão; use o código de estado para uma tabela cujo motivo de status não seja legível.
SizeBadgeSize?
Tamanho do distintivo. Padrão é o próprio do Fluent.
StateColumnstring
statecode
Coluna cujo valor determina o tom. Padrão para o código de estado.
ToneFunc<int?, StatusBadgeTone>?
Escolhe o tom do valor da coluna de estado — null quando está vazia ou retido. Padrão para StatusBadgeTone.Default(System.Nullable{System.Int32}): um tom de marca para ativo (0), um contorno neutro caso contrário. Forneça um para uma tabela com mais de dois estados.
Nome: IsVisible
Tipo: bool
Padrão: True
Descrição: O distintivo é visível?
Nome: LabelColumn
Tipo: string
Padrão: statuscode
Descrição: Coluna cujo valor formatado é o texto do distintivo. Padrão para statuscode, o status razão; use o código de estado para uma tabela cujo motivo de status não seja legível.
Nome: Size
Tipo: BadgeSize?
Descrição: Tamanho do distintivo. Padrão é o próprio do Fluent.
Nome: StateColumn
Tipo: string
Padrão: statecode
Descrição: Coluna cujo valor determina o tom. Padrão para o código de estado.
Nome: Tone
Tipo: Func<int?, StatusBadgeTone>?
Descrição: Escolhe o tom do valor da coluna de estado — null quando está vazia ou retido. Padrão para StatusBadgeTone.Default(System.Nullable{System.Int32}): um tom de marca para ativo (0), um contorno neutro caso contrário. Forneça um para uma tabela com mais de dois estados.
React Blazor

AddressDisplayValue Classe

Parâmetros

Nome
Tipo
Padrão
Descrição
Descriptionstring?
Descrição será exibida na dica de ferramenta. Volta ao {Prefixo}_composite Descrição da coluna.
DisplayLabelWhenAvailablebool
True
Especifica se deve exibir um rótulo se disponível.
DisplayTooltipWhenAvailablebool
True
Especifica se deve exibir uma dica de ferramenta, se disponível.
EmptyPlaceholderstring
—
Texto mostrado quando o endereço está vazio. Padrão para um traço em; passar uma string vazia para Suprimir.
HomeCountrystring?
O país para deixar de fora um endereço composto, por exemplo, 'Estados Unidos' para um portal cujo Endereços são quase todos domésticos. Comparado ignorando casos e sotaques. Não se aplica quando o endereço é o próprio composto do Dataverse, que é mostrado enquanto o Dataverse o formata.
IsVisiblebool
True
O endereço é visível?
Labelstring?
Texto a ser exibido como uma etiqueta. Volta para a etiqueta da coluna {Prefix}_composite , por exemplo, 'Endereço 1'.
Prefixstring
address1
O prefixo da coluna do endereço — address1, address2, ou um endereço personalizado prefixo. As partes são lidas a partir de {Prefixo}_line1... 3, _city, _stateorprovince, _postalcode, _country e _composite. O padrão é o endereço1.
Nome: Description
Tipo: string?
Descrição: Descrição será exibida na dica de ferramenta. Volta ao {Prefixo}_composite Descrição da coluna.
Nome: DisplayLabelWhenAvailable
Tipo: bool
Padrão: True
Descrição: Especifica se deve exibir um rótulo se disponível.
Nome: DisplayTooltipWhenAvailable
Tipo: bool
Padrão: True
Descrição: Especifica se deve exibir uma dica de ferramenta, se disponível.
Nome: EmptyPlaceholder
Tipo: string
Padrão: —
Descrição: Texto mostrado quando o endereço está vazio. Padrão para um traço em; passar uma string vazia para Suprimir.
Nome: HomeCountry
Tipo: string?
Descrição: O país para deixar de fora um endereço composto, por exemplo, 'Estados Unidos' para um portal cujo Endereços são quase todos domésticos. Comparado ignorando casos e sotaques. Não se aplica quando o endereço é o próprio composto do Dataverse, que é mostrado enquanto o Dataverse o formata.
Nome: IsVisible
Tipo: bool
Padrão: True
Descrição: O endereço é visível?
Nome: Label
Tipo: string?
Descrição: Texto a ser exibido como uma etiqueta. Volta para a etiqueta da coluna {Prefix}_composite , por exemplo, 'Endereço 1'.
Nome: Prefix
Tipo: string
Padrão: address1
Descrição: O prefixo da coluna do endereço — address1, address2, ou um endereço personalizado prefixo. As partes são lidas a partir de {Prefixo}_line1... 3, _city, _stateorprovince, _postalcode, _country e _composite. O padrão é o endereço1.