TextEdit

El TextEdit componente genera una entrada de texto de una sola línea para columnas de cadenas de Dataverse.

React
Blazor

Tipo de campo de texto

Configura TextFieldType para cambiar el tipo de entrada. Las opciones incluyen Text (por defecto), Email, Password, Tel, Url, Search, Number, y Color. El navegador aplica formato nativo y validación para cada tipo.

React
Blazor

Restricciones de longitud

Usar MinLength y MaxLength para imponer restricciones de longitud del texto. MaxLength se rellena automáticamente a partir de los metadatos de la columna si no se establece explícitamente.

React
Blazor

Máscaras de entrada

Configurado Mask para restringir y formatear el valor conforme el usuario escribe. MaskMode.Pattern aplica una plantilla ranurada suministrada mediante Pattern0 acepta un dígito, A una letra, * un carácter alfanumérico, y cada otro carácter es un literal insertado automáticamente. MaskMode.Regex Filtra cada carácter frente a la AllowedPattern expresión regular, eliminando todo lo que no coincida. El enmascaramiento se ejecuta en el navegador y conserva la posición del cursor mientras se reformatea, por lo que editar en medio del valor se comporta de forma natural. El valor predeterminado MaskMode.None deja el campo como una entrada de texto plano sin sobrecarga de interoperabilidad.

Almacenamiento con o sin la mascarilla

Por defecto, un campo enmascarado almacena el valor desenmascarado — para un patrón de teléfono, 5551234567 en lugar de (555) 123-4567. Configura StoreMaskedValue="true" para que el texto formateado (literales incluidos) persista en la columna en su lugar. En cualquier caso, el campo vuelve a enmascarar correctamente al cargar, así que la elección depende de lo que espere el sistema aguas abajo.

Ejemplo

Un acotamiento básico TextEdit a una columna de cadenas.

Ejemplo de reacción
Ejemplo de Blazor
React TypeScript
Razor

Opciones de configuración

Utiliza los controles a continuación para explorar las propiedades disponibles.

Ejemplo de reacción
Ejemplo de Blazor
¿Solo lectura? ¿Obligatorio? ¿Deshabilitado? ColorCorreo electrónicoNúmeroContraseñaBúsquedaTelTextoURL
React TypeScript
Razor

Preajustes de máscara

Elige una mascarilla del menú desplegable y escribe en el campo para ver enmascaramientos en directo y seguros para el cuidado. Cada preset se agrupa Mask con un Pattern o AllowedPattern. Alternar Almacenar valor enmascarado para comparar lo que se mantiene en la columna — la lectura debajo del campo refleja el valor almacenado en vivo.

Ejemplo de reacción
Ejemplo de Blazor
Ninguna (texto plano)Teléfono — (000) 000-0000SSN — 000-00-0000Tarjeta de crédito — 0000 0000 0000 0000ZIP+4 — 00000-0000Solo cartas — [A-Za-z] Almacenar valor enmascarado

Valor almacenado:

React TypeScript
Razor
Reaccionar Blazor

TextEdit Clase

Parámetros

Nombre
Tipo
Default
Descripción
AllowedPatternstring?
Por carácter permiten regex para MaskMode.Regex (por ejemplo, [A-Za-z]).
Autocompletebool
False
Activa el autocompletado del navegador para la edición de texto.
ChildContentRenderFragment?
Contenido hijo del componente
ColumnName*string
Nombre lógico de columna para vincular el editor desde el registro de la tabla.
Descriptionstring?
La descripción se mostrará en la descripción emergente.
Disabledbool?
¿Debería desactivar el editor?
DisplayLabelWhenAvailablebool
True
Especifica si mostrar una lable si está disponible.
DisplayTooltipWhenAvailablebool
True
Especifica si mostrar una descripción emergente si está disponible.
DisplayValidationErrorMessagebool
True
¿Debe mostrarse un mensaje de error de validación cuando el componente falla en la validación?
EndContentRenderFragment?
El contenido se renderizaba en la ranura final del campo (después de la entrada).
Immediatebool
False
Cuando true, el editor compromete su valor en cada pulsación de tecla (el evento de entrada DOM) en lugar de desenfocar (el evento de cambio DOM). Útil cuando varios editores asignados a la misma columna deberían mantenerse sincronizados como el usuario escribe. Por defecto, false los consumidores existentes mantienen su comportamiento de compromiso borroso. Reenviado a MaskedTextField.Immediate; Consulta esa propiedad para el matiz de enmascarado frente a camino rápido.
ImmediateDelayint
0
Debounce, en milisegundos, aplicado al pulsar la tecla cuando TextEdit.Immediate es true. Cero (el valor predeterminado) se hace commits en cada pulsación de tecla; Los valores positivos esperan tanto tiempo después de la última pulsación de tecla Valor de disparo Cambiado. Reenviado a MaskedTextField.ImmediateDelay.
IsVisiblebool
True
¿El editor es visible?
Labelstring?
El texto se mostrará como etiqueta para el editor.
MaskMaskMode
None
Estrategia de enmascaramiento aplicada a la entrada. Por defecto es MaskMode.None, que mantiene el campo en el camino rápido de interoperación cero (un campo de texto encuadernado plano). A ajustar MaskMode.Pattern o MaskMode.Regex para permitir el uso de mascarillas seguras para el cuidado.
MaxLengthint?
Longitud máxima de la cuerda permitida.
MinLengthint?
Longitud máxima de la cuerda permitida.
Patternstring?
Plantilla ranurada para MaskMode.Pattern (por ejemplo, (000) 000-0000).
ReadOnlybool?
¿Debería el editor ser solo lectura?
Requiredbool?
Si el valor es necesario.
Rowsint?
Cuando se especifica, determina el número de filas que ocupará el control.
StartContentRenderFragment?
Contenido renderizado en la ranura de inicio del campo (antes de la entrada) — un icono, prefijo, etc.
StoreMaskedValuebool
False
Controla si un valor enmascarado se almacena con o sin la máscara. Cuando true, la columna almacena el texto enmascarado incluyendo literales/separadores (por ejemplo , (555) 123-4567); cuando false (el valor por defecto), almacena el valor desenmascarado (por ejemplo , 5551234567). No tiene efecto cuando TextEdit.Mask es MaskMode.None.
TextFieldTypeTextFieldType
Text
Tipo de campo para la edición de texto
Valuestring?
Valor del control.
Nombre: AllowedPattern
Tipo: string?
Descripción: Por carácter permiten regex para MaskMode.Regex (por ejemplo, [A-Za-z]).
Nombre: Autocomplete
Tipo: bool
Default: False
Descripción: Activa el autocompletado del navegador para la edición de texto.
Nombre: ChildContent
Tipo: RenderFragment?
Descripción: Contenido hijo del componente
Nombre: ColumnName*
Tipo: string
Descripción: Nombre lógico de columna para vincular el editor desde el registro de la tabla.
Nombre: Description
Tipo: string?
Descripción: La descripción se mostrará en la descripción emergente.
Nombre: Disabled
Tipo: bool?
Descripción: ¿Debería desactivar el editor?
Nombre: DisplayLabelWhenAvailable
Tipo: bool
Default: True
Descripción: Especifica si mostrar una lable si está disponible.
Nombre: DisplayTooltipWhenAvailable
Tipo: bool
Default: True
Descripción: Especifica si mostrar una descripción emergente si está disponible.
Nombre: DisplayValidationErrorMessage
Tipo: bool
Default: True
Descripción: ¿Debe mostrarse un mensaje de error de validación cuando el componente falla en la validación?
Nombre: EndContent
Tipo: RenderFragment?
Descripción: El contenido se renderizaba en la ranura final del campo (después de la entrada).
Nombre: Immediate
Tipo: bool
Default: False
Descripción: Cuando true, el editor compromete su valor en cada pulsación de tecla (el evento de entrada DOM) en lugar de desenfocar (el evento de cambio DOM). Útil cuando varios editores asignados a la misma columna deberían mantenerse sincronizados como el usuario escribe. Por defecto, false los consumidores existentes mantienen su comportamiento de compromiso borroso. Reenviado a MaskedTextField.Immediate; Consulta esa propiedad para el matiz de enmascarado frente a camino rápido.
Nombre: ImmediateDelay
Tipo: int
Default: 0
Descripción: Debounce, en milisegundos, aplicado al pulsar la tecla cuando TextEdit.Immediate es true. Cero (el valor predeterminado) se hace commits en cada pulsación de tecla; Los valores positivos esperan tanto tiempo después de la última pulsación de tecla Valor de disparo Cambiado. Reenviado a MaskedTextField.ImmediateDelay.
Nombre: IsVisible
Tipo: bool
Default: True
Descripción: ¿El editor es visible?
Nombre: Label
Tipo: string?
Descripción: El texto se mostrará como etiqueta para el editor.
Nombre: Mask
Tipo: MaskMode
Default: None
Descripción: Estrategia de enmascaramiento aplicada a la entrada. Por defecto es MaskMode.None, que mantiene el campo en el camino rápido de interoperación cero (un campo de texto encuadernado plano). A ajustar MaskMode.Pattern o MaskMode.Regex para permitir el uso de mascarillas seguras para el cuidado.
Nombre: MaxLength
Tipo: int?
Descripción: Longitud máxima de la cuerda permitida.
Nombre: MinLength
Tipo: int?
Descripción: Longitud máxima de la cuerda permitida.
Nombre: Pattern
Tipo: string?
Descripción: Plantilla ranurada para MaskMode.Pattern (por ejemplo, (000) 000-0000).
Nombre: ReadOnly
Tipo: bool?
Descripción: ¿Debería el editor ser solo lectura?
Nombre: Required
Tipo: bool?
Descripción: Si el valor es necesario.
Nombre: Rows
Tipo: int?
Descripción: Cuando se especifica, determina el número de filas que ocupará el control.
Nombre: StartContent
Tipo: RenderFragment?
Descripción: Contenido renderizado en la ranura de inicio del campo (antes de la entrada) — un icono, prefijo, etc.
Nombre: StoreMaskedValue
Tipo: bool
Default: False
Descripción: Controla si un valor enmascarado se almacena con o sin la máscara. Cuando true, la columna almacena el texto enmascarado incluyendo literales/separadores (por ejemplo , (555) 123-4567); cuando false (el valor por defecto), almacena el valor desenmascarado (por ejemplo , 5551234567). No tiene efecto cuando TextEdit.Mask es MaskMode.None.
Nombre: TextFieldType
Tipo: TextFieldType
Default: Text
Descripción: Tipo de campo para la edición de texto
Nombre: Value
Tipo: string?
Descripción: Valor del control.

Eventos

Nombre
Tipo
Descripción
ValueChangedEventCallback<ColumnValueBase>
Recibe o establece una callback que actualiza el valor vinculado.
Nombre: ValueChanged
Tipo: EventCallback<ColumnValueBase>
Descripción: Recibe o establece una callback que actualiza el valor vinculado.

Métodos

Nombre
Parámetros
Tipo
Descripción
GetValidationErrorsList<string>
Devuelve una colección de los errores de validación actuales.
Nombre: GetValidationErrors
Tipo: List<string>
Descripción: Devuelve una colección de los errores de validación actuales.