TextEdit

Le TextEdit composant affiche une entrée texte à une ligne pour les colonnes de chaînes Dataverse.

React
Blazor

Type de champ de texte

Régler TextFieldType pour changer le type d’entrée. Les options incluent Text (par défaut), Email, Password, Tel, SearchUrl, , Number, , et Color. Le navigateur applique une mise en forme native et une validation pour chaque type.

React
Blazor

Contraintes de longueur

Utiliser MinLength et MaxLength pour imposer des contraintes de longueur du texte. MaxLength est automatiquement généré à partir des métadonnées de colonne si elle n’est pas explicitement définie.

React
Blazor

Masques d’entrée

Défini Mask pour contraindre et formater la valeur au fur et à mesure que l’utilisateur tape. MaskMode.Pattern applique un modèle à fentes fourni via Pattern0 accepte un chiffre, A une lettre, * un caractère alphanumérique, et chaque autre caractère est un littéral inséré automatiquement. MaskMode.Regex filtre chaque caractère par rapport à l’expression AllowedPattern régulière, en supprimant tout ce qui ne correspond pas. Le masquage s’exécute dans le navigateur et conserve la position du caret lors du reformatage, donc l’édition au milieu de la valeur se comporte naturellement. Par défaut MaskMode.None , le champ est une entrée en texte brut sans surcoût d’interopération.

Stockage avec ou sans masque

Par défaut, un champ masqué stocke la valeur non masquée — pour un motif de téléphone, 5551234567 plutôt que (555) 123-4567. Réglez StoreMaskedValue="true" pour que le texte formaté (littéraux inclus) persiste dans la colonne à la place. Dans tous les cas, le champ se remasque correctement en charge, donc le choix dépend de ce que le système aval attend.

Exemple

Une borne de base TextEdit à une colonne de chaînes.

Exemple de réaction
Exemple de Blazor
React TypeScript
Razor

Configuration Options

Utilisez les commandes ci-dessous pour explorer les propriétés disponibles.

Exemple de réaction
Exemple de Blazor
Lecture seule ? Obligatoire ? Handicapé ? CouleurEmailNuméroMot de passeRechercheTelTexteURL
React TypeScript
Razor

Préréglages de masque

Choisissez un masque dans le menu déroulant et tapez dans le champ pour voir un masque en direct, sûr pour la sécurité. Chaque préréglage s’établit Mask avec un Pattern ou AllowedPattern. Stockez la valeur masquée pour comparer ce qui est conservé dans la colonne — la lecture sous le champ reflète la valeur stockée en direct.

Exemple de réaction
Exemple de Blazor
Aucun (texte brut)Téléphone — (000) 000-0000SSN — 000-00-0000Carte de crédit — 0000 0000 0000 0000ZIP +4 — 00000-0000Lettres seulement — [A-Za-z] Stocker la valeur masquée

Valeur stockée:

React TypeScript
Razor
Réagir Blazor

TextEdit Classe

Paramètres

Nom
Type
Par défaut
Description
AllowedPatternstring?
Par caractère autorisent la régulation pour MaskMode.Regex (par exemple [A-Za-z]).
Autocompletebool
False
Permet l’autocomplétion du navigateur pour la modification de texte.
ChildContentRenderFragment?
Contenu enfant du composant
ColumnName*string
Nom logique de colonne pour lier l’éditeur à partir de l’enregistrement de table.
Descriptionstring?
Description à afficher dans l’infobulle.
Disabledbool?
Si l’éditeur est désactivé.
DisplayLabelWhenAvailablebool
True
Précise s’il faut afficher une étiquette si disponible.
DisplayTooltipWhenAvailablebool
True
Précise s’il faut afficher une infobulle si disponible.
DisplayValidationErrorMessagebool
True
Un message d’erreur de validation doit-il s’afficher lorsque le composant échoue à la validation ?
EndContentRenderFragment?
Le contenu était rendu dans la fente de fin du champ (après l’entrée).
Immediatebool
False
Lorsque true, l’éditeur valide sa valeur à chaque frappe (l’événement d’entrée DOM) au lieu de flou (l’événement de changement DOM). Utile lorsque plusieurs éditeurs sont liés à la même colonne et doivent rester synchronisés comme l’utilisateur tape. Par défaut, false les consommateurs existants conservent Leur comportement de « flou-engagement ». Transféré à MaskedTextField.Immediate; Voir cette propriété pour la nuance de chemin masqué vs rapide.
ImmediateDelayint
0
Debounce, en millisecondes, appliqué à la pression sur la touche lorsque TextEdit.Immediate est true. Zero (le défaut) commit sur chaque frappe ; Les valeurs positives attendent aussi longtemps après la dernière frappe avant Valeur de tir Modifiée. Transféré vers MaskedTextField.ImmediateDelay.
IsVisiblebool
True
L’éditeur est-il visible ?
Labelstring?
Le texte doit être affiché comme une étiquette pour l’éditeur.
MaskMaskMode
None
Stratégie de masquage appliquée à l’entrée. Par défaut est MaskMode.None, ce qui conserve le champ sur le chemin rapide sans interop (un champ de texte lié en clair). Réglé à MaskMode.Pattern ou MaskMode.Regex pour permettre un port de masque sûr pour les carettes.
MaxLengthint?
Longueur maximale de la corde autorisée.
MinLengthint?
Longueur maximale de la corde autorisée.
Patternstring?
Modèle à fentes pour MaskMode.Pattern (par exemple (000) 000-0000).
ReadOnlybool?
L’éditeur devrait-il être en lecture seule ?
Requiredbool?
Si la valeur est requise.
Rowsint?
Lorsqu’elle est spécifiée, détermine le nombre de lignes que le contrôle occupera.
StartContentRenderFragment?
Contenu rendu dans la case de démarrage du champ (avant l’entrée) — une icône, un préfixe, etc.
StoreMaskedValuebool
False
Contrôle si une valeur masquée est stockée avec ou sans le masque. Quand true, la colonne stocke le texte masqué incluant les littéraux/séparateurs (par exemple (555) 123-4567) ; quand false (par défaut), il stocke la valeur démasquée (par exemple 5551234567). Ça n’a aucun effet lorsque TextEdit.Mask est MaskMode.None.
TextFieldTypeTextFieldType
Text
Type de champ pour la modification du texte
Valuestring?
La valeur du contrôle.
Nom: AllowedPattern
Type: string?
Description: Par caractère autorisent la régulation pour MaskMode.Regex (par exemple [A-Za-z]).
Nom: Autocomplete
Type: bool
Par défaut: False
Description: Permet l’autocomplétion du navigateur pour la modification de texte.
Nom: ChildContent
Type: RenderFragment?
Description: Contenu enfant du composant
Nom: ColumnName*
Type: string
Description: Nom logique de colonne pour lier l’éditeur à partir de l’enregistrement de table.
Nom: Description
Type: string?
Description: Description à afficher dans l’infobulle.
Nom: Disabled
Type: bool?
Description: Si l’éditeur est désactivé.
Nom: DisplayLabelWhenAvailable
Type: bool
Par défaut: True
Description: Précise s’il faut afficher une étiquette si disponible.
Nom: DisplayTooltipWhenAvailable
Type: bool
Par défaut: True
Description: Précise s’il faut afficher une infobulle si disponible.
Nom: DisplayValidationErrorMessage
Type: bool
Par défaut: True
Description: Un message d’erreur de validation doit-il s’afficher lorsque le composant échoue à la validation ?
Nom: EndContent
Type: RenderFragment?
Description: Le contenu était rendu dans la fente de fin du champ (après l’entrée).
Nom: Immediate
Type: bool
Par défaut: False
Description: Lorsque true, l’éditeur valide sa valeur à chaque frappe (l’événement d’entrée DOM) au lieu de flou (l’événement de changement DOM). Utile lorsque plusieurs éditeurs sont liés à la même colonne et doivent rester synchronisés comme l’utilisateur tape. Par défaut, false les consommateurs existants conservent Leur comportement de « flou-engagement ». Transféré à MaskedTextField.Immediate; Voir cette propriété pour la nuance de chemin masqué vs rapide.
Nom: ImmediateDelay
Type: int
Par défaut: 0
Description: Debounce, en millisecondes, appliqué à la pression sur la touche lorsque TextEdit.Immediate est true. Zero (le défaut) commit sur chaque frappe ; Les valeurs positives attendent aussi longtemps après la dernière frappe avant Valeur de tir Modifiée. Transféré vers MaskedTextField.ImmediateDelay.
Nom: IsVisible
Type: bool
Par défaut: True
Description: L’éditeur est-il visible ?
Nom: Label
Type: string?
Description: Le texte doit être affiché comme une étiquette pour l’éditeur.
Nom: Mask
Type: MaskMode
Par défaut: None
Description: Stratégie de masquage appliquée à l’entrée. Par défaut est MaskMode.None, ce qui conserve le champ sur le chemin rapide sans interop (un champ de texte lié en clair). Réglé à MaskMode.Pattern ou MaskMode.Regex pour permettre un port de masque sûr pour les carettes.
Nom: MaxLength
Type: int?
Description: Longueur maximale de la corde autorisée.
Nom: MinLength
Type: int?
Description: Longueur maximale de la corde autorisée.
Nom: Pattern
Type: string?
Description: Modèle à fentes pour MaskMode.Pattern (par exemple (000) 000-0000).
Nom: ReadOnly
Type: bool?
Description: L’éditeur devrait-il être en lecture seule ?
Nom: Required
Type: bool?
Description: Si la valeur est requise.
Nom: Rows
Type: int?
Description: Lorsqu’elle est spécifiée, détermine le nombre de lignes que le contrôle occupera.
Nom: StartContent
Type: RenderFragment?
Description: Contenu rendu dans la case de démarrage du champ (avant l’entrée) — une icône, un préfixe, etc.
Nom: StoreMaskedValue
Type: bool
Par défaut: False
Description: Contrôle si une valeur masquée est stockée avec ou sans le masque. Quand true, la colonne stocke le texte masqué incluant les littéraux/séparateurs (par exemple (555) 123-4567) ; quand false (par défaut), il stocke la valeur démasquée (par exemple 5551234567). Ça n’a aucun effet lorsque TextEdit.Mask est MaskMode.None.
Nom: TextFieldType
Type: TextFieldType
Par défaut: Text
Description: Type de champ pour la modification du texte
Nom: Value
Type: string?
Description: La valeur du contrôle.

Événements

Nom
Type
Description
ValueChangedEventCallback<ColumnValueBase>
Obtient ou définit un callback qui met à jour la valeur liée.
Nom: ValueChanged
Type: EventCallback<ColumnValueBase>
Description: Obtient ou définit un callback qui met à jour la valeur liée.

Méthodes

Nom
Paramètres
Type
Description
GetValidationErrorsList<string>
Retourne une collection des erreurs de validation courantes.
Nom: GetValidationErrors
Type: List<string>
Description: Retourne une collection des erreurs de validation courantes.