Anzeigewerte

Schreibgeschützte Bausteine für Datensatzseiten: ein Statusausweis, eine Postadresse und eine Möglichkeit, den Wert einer Spalte im Code zu lesen, ohne das Drahtformat zu dekodieren.

Den Wert einer Spalte lesen

Um auf einen Wert zu verzweigen (einen Status zu färben, eine Flagge anzuzeigen, ein Datum zu vergleichen), liest man den Rohwert der Spalte statt des Labels, das lokalisiert ist. In React wird useColumnValue(columnName) der Wert einer Spalte der Umgebung RecordContext als einfacher JavaScript-Typ zurückgegeben, mit der formatierten Zeichenkette und den Metadaten der Spalte daneben. In Blazor liest man den getippten Wert aus dem Datensatz mit GetValueOrDefault<T>. In jedem Fall liest sich eine Spalte, die leer ist oder durch die Spaltensicherheit zurückgehalten wird, als null; CanReadColumn unterscheidet die beiden.

React Blazor

Außerhalb eines RecordContext, zum Beispiel in einem Rasterzellen-Renderer oder einem Diagramm-Tooltip, rufe von @powerportalspro/core auf dem Datensatz auf, readColumnRawValue(record, columnName) den du hältst.

Statusabzeichen

ColumnStatusBadge zeigt den Status des Datensatzes (statuscode) und erhält seine Farbe vom Zustand (statecode): eine Markenfarbe während der aktiven Zeit, ansonsten eine neutrale Umrissung. Die Farbe stammt vom Wert des Zustands, nicht vom Etikett, sodass sie in jeder Sprache gilt. Nichts wird gerendert, wenn das Etikett leer oder zurückgehalten wird.

React-Beispiel Blazor-Beispiel React TypeScript Razor
Contoso Ltd Active
Fabrikam, Inc. Inactive

Benutzerdefinierte Töne

Für eine Tabelle mit mehr als zwei Zuständen übergebe man eine Tone Funktion, die den Wert des Zustands auf die Farbe und das Aussehen des Abzeichens abbildet. Sie erhält null , wenn der Zustand leer oder zurückgehalten ist.

React Blazor

Adresse

AddressDisplayValue rendert eine der Adressen einer Tabelle (address1, address2, ...) in einem <address> Element, mit demselben Label wie ColumnDisplayValue. Es zeigt die Spalte _composite von Dataverse an, wenn der Benutzer sie lesen kann. Ansonsten setzt es die Straßenlinien, dann Stadt, Region und Postleitzahl sowie das Land, das es weglässt, wenn es übereinstimmt HomeCountry.

React-Beispiel Blazor-Beispiel React TypeScript Razor
1 Microsoft Way
Building 92
Redmond, WA 98052
70 Wilson Street
London, EC2A 2DB
United Kingdom
Reagieren Blazor

ColumnStatusBadge Baureihe

Parameter

Name
Typ
Default
Beschreibung
IsVisiblebool
True
Ist das Abzeichen sichtbar?
LabelColumnstring
statuscode
Spalte, deren formatierter Wert der Text des Abzeichens ist. Standardmäßig steht der Status auf Statuscode, der Status Reason; verwenden Sie Statecode für eine Tabelle, deren Statusgrund nicht lesbar ist.
SizeBadgeSize?
Badge-Größe. Standardmäßig Fluents eigene.
StateColumnstring
statecode
Spalte, deren Wert den Ton bestimmt. Standardmäßig ist Statecode.
ToneFunc<int?, StatusBadgeTone>?
Wählt den Ton aus dem Wert der Zustandsspalte – null wenn er leer ist oder Zurückgehalten. Standardeinstellung lautet StatusBadgeTone.Default(System.Nullable{System.Int32}): eine Markentönung für aktiv (0), eine neutrale Umrisslinie ansonsten. Liefern Sie eine für eine Tabelle mit mehr als zwei Zuständen.
Name: IsVisible
Typ: bool
Default: True
Beschreibung: Ist das Abzeichen sichtbar?
Name: LabelColumn
Typ: string
Default: statuscode
Beschreibung: Spalte, deren formatierter Wert der Text des Abzeichens ist. Standardmäßig steht der Status auf Statuscode, der Status Reason; verwenden Sie Statecode für eine Tabelle, deren Statusgrund nicht lesbar ist.
Name: Size
Typ: BadgeSize?
Beschreibung: Badge-Größe. Standardmäßig Fluents eigene.
Name: StateColumn
Typ: string
Default: statecode
Beschreibung: Spalte, deren Wert den Ton bestimmt. Standardmäßig ist Statecode.
Name: Tone
Typ: Func<int?, StatusBadgeTone>?
Beschreibung: Wählt den Ton aus dem Wert der Zustandsspalte – null wenn er leer ist oder Zurückgehalten. Standardeinstellung lautet StatusBadgeTone.Default(System.Nullable{System.Int32}): eine Markentönung für aktiv (0), eine neutrale Umrisslinie ansonsten. Liefern Sie eine für eine Tabelle mit mehr als zwei Zuständen.
Reagieren Blazor

AddressDisplayValue Baureihe

Parameter

Name
Typ
Default
Beschreibung
Descriptionstring?
Beschreibung, die im Tooltip angezeigt wird. Greift auf das {Präfix} zurück_composite Beschreibung der Kolumne.
DisplayLabelWhenAvailablebool
True
Spezifiziert, ob ein Etikett angezeigt werden soll, falls verfügbar.
DisplayTooltipWhenAvailablebool
True
Gibt an, ob ein Tooltip angezeigt werden soll, falls verfügbar.
EmptyPlaceholderstring
—
Text, der angezeigt wird, wenn die Adresse leer ist. Standardmäßig wird ein Bindestrich verwendet; übergebe eine leere Zeichenkette an Unterdrücken.
HomeCountrystring?
Das Land, das eine komponierte Adresse weglässt, z. B. 'United States' für ein Portal, dessen Portal Die Adressen sind fast alle häuslich. Verglichen, ohne Kasus und Akzente zu berücksichtigen. Trifft nicht zu, wenn die Adresse ist die eigene Zusammensetzung von Dataverse, die als Dataverse-Format angezeigt wird.
IsVisiblebool
True
Ist die Adresse sichtbar?
Labelstring?
Text wird als Etikett angezeigt. Greift auf das Label der {Präfix}_composite Spalte zurück, z. B. 'Adresse 1'.
Prefixstring
address1
Das Spaltenpräfix der Adresse — Adresse1, Adresse2 oder das Präfix einer benutzerdefinierten Adresse Präfix. Die Teile werden von {Präfix} gelesen_line1... 3, _city, _stateorprovince, _postalcode, _country und _composite. Standardeinstellung ist Adresse1.
Name: Description
Typ: string?
Beschreibung: Beschreibung, die im Tooltip angezeigt wird. Greift auf das {Präfix} zurück_composite Beschreibung der Kolumne.
Name: DisplayLabelWhenAvailable
Typ: bool
Default: True
Beschreibung: Spezifiziert, ob ein Etikett angezeigt werden soll, falls verfügbar.
Name: DisplayTooltipWhenAvailable
Typ: bool
Default: True
Beschreibung: Gibt an, ob ein Tooltip angezeigt werden soll, falls verfügbar.
Name: EmptyPlaceholder
Typ: string
Default: —
Beschreibung: Text, der angezeigt wird, wenn die Adresse leer ist. Standardmäßig wird ein Bindestrich verwendet; übergebe eine leere Zeichenkette an Unterdrücken.
Name: HomeCountry
Typ: string?
Beschreibung: Das Land, das eine komponierte Adresse weglässt, z. B. 'United States' für ein Portal, dessen Portal Die Adressen sind fast alle häuslich. Verglichen, ohne Kasus und Akzente zu berücksichtigen. Trifft nicht zu, wenn die Adresse ist die eigene Zusammensetzung von Dataverse, die als Dataverse-Format angezeigt wird.
Name: IsVisible
Typ: bool
Default: True
Beschreibung: Ist die Adresse sichtbar?
Name: Label
Typ: string?
Beschreibung: Text wird als Etikett angezeigt. Greift auf das Label der {Präfix}_composite Spalte zurück, z. B. 'Adresse 1'.
Name: Prefix
Typ: string
Default: address1
Beschreibung: Das Spaltenpräfix der Adresse — Adresse1, Adresse2 oder das Präfix einer benutzerdefinierten Adresse Präfix. Die Teile werden von {Präfix} gelesen_line1... 3, _city, _stateorprovince, _postalcode, _country und _composite. Standardeinstellung ist Adresse1.