TextEdit
Die Komponente TextEdit rendert eine einzeilige Texteingabe für Dataverse-String-Spalten.
Textfeldtyp
Stellen Sie ein, TextFieldType um den Eingangstyp zu ändern. Optionen sind Text (Standard), Email, Password, , Tel, Url, Search, Number, und Color. Der Browser wendet native Formatierung und Validierung für jeden Typ an.
Längenbeschränkungen
Verwenden MinLength und MaxLength zur Durchsetzung von Textlängenbeschränkungen. MaxLength wird automatisch aus den Spaltenmetadaten befüllt, sofern nicht explizit gesetzt.
Eingabemasken
Setzen Sie die Einschränkung Mask und Formatierung des Wertes, während der Benutzer eingibt. MaskMode.Pattern verwendet eine Slot-Vorlage, die über Pattern — 0 akzeptiert eine Ziffer, A einen Buchstaben, * ein alphanumerisches Zeichen und jedes zweite Zeichen automatisch als Literal eingefügt wird. MaskMode.Regex Filtert jedes Zeichen gegen den regulären AllowedPattern Ausdruck und lässt alles weg, was nicht übereinstimmt. Das Maskieren läuft im Browser und bewahrt die Caret-Position beim Neuformatieren, sodass sich das Bearbeiten in der Mitte des Wertes natürlich verhält. Standardmäßig MaskMode.None bleibt das Feld eine einfache Texteingabe ohne Interop-Overhead.
Lagerung mit oder ohne Maske
Standardmäßig speichert ein maskiertes Feld den unmaskierten Wert – für ein Telefonmuster 5551234567 (555) 123-4567statt . Stattdessen soll StoreMaskedValue="true" der formatierte Text (Literale und alles) in der Spalte gespeichert werden. So oder so maskiert das Feld bei der Last korrekt, sodass die Entscheidung darauf ankommt, was das nachgelagerte System erwartet.
Beispiel
Eine grundlegende TextEdit Bindung an eine String-Spalte.
Konfigurationsoptionen
Nutzen Sie die untenstehenden Steuerungen, um die verfügbaren Immobilien zu erkunden.
Maskenvoreinstellungen
Wählen Sie eine Maske aus dem Dropdown-Menü und tippen Sie ins Feld ein, um Live-Caret-sichere Maskierungen zu sehen. Jedes Preset setzt Mask zusammen mit einem Pattern oder AllowedPattern. Schalten Sie den maskierten Wert speichern , um zu vergleichen, was gespeichert wird, mit der Spalte – die Anzeige unter dem Feld spiegelt den gespeicherten Wert live wider.
Gespeicherter Wert:
—
TextEdit Baureihe
Parameter
Name | Typ | Default | Beschreibung |
|---|---|---|---|
AllowedPattern | string? | Per-Zeichen erlaubt Regex für MaskMode.Regex (z. B. | |
Autocomplete | bool | False | Aktiviert die automatische Vervollständigung des Browsers für die Textbearbeitung. |
ChildContent | RenderFragment? | Kindinhalt der Komponente | |
ColumnName* | string | Spaltenlogischer Name, um den Editor aus dem Tabelleneintrag zu binden. | |
Description | string? | Beschreibung wird im Tooltip angezeigt. | |
Disabled | bool? | Sollte der Editor deaktiviert werden? | |
DisplayLabelWhenAvailable | bool | True | Gibt an, ob eine Etikette angezeigt werden soll, falls verfügbar. |
DisplayTooltipWhenAvailable | bool | True | Gibt an, ob ein Tooltip angezeigt werden soll, falls verfügbar. |
DisplayValidationErrorMessage | bool | True | Sollte eine Fehlermeldung zur Validierung angezeigt werden, wenn die Komponente die Validierung nicht besteht? |
EndContent | RenderFragment? | Inhalte werden im | |
Immediate | bool | False | Wenn true, verbindet der Editor seinen Wert bei jedem Tastendruck (das false bestehende Verbraucher erhalten Ihr verschwommenes Committ-Verhalten. Weitergeleitet an MaskedTextField.Immediate; Sehen Sie diese Eigenschaft für die Nuance zwischen maskiertem und schnellem Weg. |
ImmediateDelay | int | 0 | Debounce, in Millisekunden, angewendet auf den Tastendruck, wenn TextEdit.Immediate ist true. Zero (der Standard) commits auf jeden Tastendruck; Positive Werte warten so lange nach dem letzten Tastendruck MaskedTextField.ImmediateDelay. |
IsVisible | bool | True | Ist der Editor sichtbar? |
Label | string? | Text soll als Etikett für den Editor angezeigt werden. | |
Mask | MaskMode | None | Masking-Strategie angewandt auf die Eingabe. Standardmäßig gilt , MaskMode.Nonewas beibehalten bleibt das Feld auf dem Null-Interop-Schnellpfad (ein einfach gebundenes Textfeld). Stellen Sie auf MaskMode.Pattern oder MaskMode.Regex um caret-sichere Maskierung zu ermöglichen. |
MaxLength | int? | Maximale Länge der zulässigen Saite. | |
MinLength | int? | Maximale Länge der zulässigen Saite. | |
Pattern | string? | Schlitzvorlage für MaskMode.Pattern (z. B. | |
ReadOnly | bool? | Sollte der Editor nur lesegeschützt sein? | |
Required | bool? | Sollte der Wert erforderlich sein. | |
Rows | int? | Wenn angegeben, bestimmt er die Anzahl der Zeilen, die die Steuerung einnehmen wird. | |
StartContent | RenderFragment? | Inhalte, die im | |
StoreMaskedValue | bool | False | Kontrolliert, ob ein maskierter Wert mit oder ohne die Maske gespeichert wird. Wenn true, die Spalte speichert den maskierten Text einschließlich Literalen/Trennern (z. B. false (der Standard), speichert er den unmaskierten Wert (z. B. TextEdit.Mask .MaskMode.None |
TextFieldType | TextFieldType | Text | Feldtyp für die Textbearbeitung |
Value | string? | Wert der Kontrolle. |
Name:
AllowedPatternTyp:
string?
Beschreibung:
Per-Zeichen erlaubt Regex für [A-Za-z] ).
MaskMode.Regex (z. B. Name:
AutocompleteTyp:
bool
Default:
False
Beschreibung:
Aktiviert die automatische Vervollständigung des Browsers für die Textbearbeitung.
Name:
ChildContentTyp:
RenderFragment?
Beschreibung:
Kindinhalt der Komponente
Name:
ColumnName*Typ:
string
Beschreibung:
Spaltenlogischer Name, um den Editor aus dem Tabelleneintrag zu binden.
Name:
DescriptionTyp:
string?
Beschreibung:
Beschreibung wird im Tooltip angezeigt.
Name:
DisabledTyp:
bool?
Beschreibung:
Sollte der Editor deaktiviert werden?
Name:
DisplayLabelWhenAvailableTyp:
bool
Default:
True
Beschreibung:
Gibt an, ob eine Etikette angezeigt werden soll, falls verfügbar.
Name:
DisplayTooltipWhenAvailableTyp:
bool
Default:
True
Beschreibung:
Gibt an, ob ein Tooltip angezeigt werden soll, falls verfügbar.
Name:
DisplayValidationErrorMessageTyp:
bool
Default:
True
Beschreibung:
Sollte eine Fehlermeldung zur Validierung angezeigt werden, wenn die Komponente die Validierung nicht besteht?
Name:
EndContentTyp:
RenderFragment?
Beschreibung:
Inhalte werden im End-Slot des Feldes (nach der Eingabe) gerendert.
Name:
ImmediateTyp:
bool
Default:
False
Beschreibung:
Wenn DOM-Eingabeereignis ) statt auf Unschärfe (das DOM-Wechselereignis ). Nützlich, wenn mehrere Editoren, die an dieselbe Spalte gebunden sind, synchron bleiben sollten als die Nutzertypen. Standardmäßig bleibt
true, verbindet der Editor seinen Wert bei jedem Tastendruck (das false bestehende Verbraucher erhalten Ihr verschwommenes Committ-Verhalten. Weitergeleitet an MaskedTextField.Immediate; Sehen Sie diese Eigenschaft für die Nuance zwischen maskiertem und schnellem Weg.Name:
ImmediateDelayTyp:
int
Default:
0
Beschreibung:
Debounce, in Millisekunden, angewendet auf den Tastendruck, wenn Entlassung von ValueChanged . Weitergeleitet an
TextEdit.Immediate ist true. Zero (der Standard) commits auf jeden Tastendruck; Positive Werte warten so lange nach dem letzten Tastendruck MaskedTextField.ImmediateDelay.Name:
IsVisibleTyp:
bool
Default:
True
Beschreibung:
Ist der Editor sichtbar?
Name:
LabelTyp:
string?
Beschreibung:
Text soll als Etikett für den Editor angezeigt werden.
Name:
MaskTyp:
MaskMode
Default:
None
Beschreibung:
Masking-Strategie angewandt auf die Eingabe. Standardmäßig gilt ,
MaskMode.Nonewas beibehalten bleibt das Feld auf dem Null-Interop-Schnellpfad (ein einfach gebundenes Textfeld). Stellen Sie auf MaskMode.Pattern oder MaskMode.Regex um caret-sichere Maskierung zu ermöglichen.Name:
MaxLengthTyp:
int?
Beschreibung:
Maximale Länge der zulässigen Saite.
Name:
MinLengthTyp:
int?
Beschreibung:
Maximale Länge der zulässigen Saite.
Name:
PatternTyp:
string?
Beschreibung:
Schlitzvorlage für (000) 000-0000).
MaskMode.Pattern (z. B. Name:
ReadOnlyTyp:
bool?
Beschreibung:
Sollte der Editor nur lesegeschützt sein?
Name:
RequiredTyp:
bool?
Beschreibung:
Sollte der Wert erforderlich sein.
Name:
RowsTyp:
int?
Beschreibung:
Wenn angegeben, bestimmt er die Anzahl der Zeilen, die die Steuerung einnehmen wird.
Name:
StartContentTyp:
RenderFragment?
Beschreibung:
Inhalte, die im Startplatz des Feldes (vor der Eingabe) gerendert wurden – ein Symbol, ein Präfix usw.
Name:
StoreMaskedValueTyp:
bool
Default:
False
Beschreibung:
Kontrolliert, ob ein maskierter Wert mit oder ohne die Maske gespeichert wird. Wenn (555) 123-4567 ); wenn 5551234567 ). Hat keine Auswirkung, wenn
true, die Spalte speichert den maskierten Text einschließlich Literalen/Trennern (z. B. false (der Standard), speichert er den unmaskierten Wert (z. B. TextEdit.Mask .MaskMode.NoneName:
TextFieldTypeTyp:
TextFieldType
Default:
Text
Beschreibung:
Feldtyp für die Textbearbeitung
Name:
ValueTyp:
string?
Beschreibung:
Wert der Kontrolle.
Veranstaltungen
Name | Typ | Beschreibung |
|---|---|---|
ValueChanged | EventCallback<ColumnValueBase> | Erhält oder setzt einen Callback, der den gebundenen Wert aktualisiert. |
Name:
ValueChangedTyp:
EventCallback<ColumnValueBase>
Beschreibung:
Erhält oder setzt einen Callback, der den gebundenen Wert aktualisiert.
Methoden
Name | Parameter | Typ | Beschreibung |
|---|---|---|---|
GetValidationErrors | List<string> | Gibt eine Sammlung der aktuellen Validierungsfehler zurück. |
Name:
GetValidationErrorsTyp:
List<string>
Beschreibung:
Gibt eine Sammlung der aktuellen Validierungsfehler zurück.