TextEdit

O TextEdit componente gera uma entrada de texto de linha única para colunas de strings do Dataverse.

React
Blazor

Tipo de Campo de Texto

Configure TextFieldType para mudar o tipo de entrada. As opções incluem Text (padrão), Email, Password, Tel, Url, Search, Number, e Color. O navegador aplica formatação nativa e validação para cada tipo.

React
Blazor

Restrições de comprimento

Use MinLength e MaxLength para impor restrições de comprimento do texto. MaxLength é automaticamente preenchido a partir dos metadados da coluna se não estiver explicitamente definido.

React
Blazor

Máscaras de entrada

Configurado Mask para restringir e formatar o valor conforme o usuário digita. MaskMode.Pattern aplica um modelo com slot fornecido via Pattern0 aceita um dígito, A uma letra, * um caractere alfanumérico, e cada outro caractere é um literal inserido automaticamente. MaskMode.Regex filtra cada caractere em relação à AllowedPattern expressão regular, eliminando tudo que não corresponde. O mascaramento roda no navegador e preserva a posição do caret enquanto ele formata, então editar no meio do valor se comporta naturalmente. O padrão MaskMode.None deixa o campo como uma entrada de texto simples sem overhead de interoperabilidade.

Armazenando com ou sem a máscara

Por padrão, um campo mascarado armazena o valor desmascarado — para um padrão de telefone, 5551234567 em vez de (555) 123-4567. Configure StoreMaskedValue="true" para persistir o texto formatado (literal e tudo) na coluna. De qualquer forma, o campo re-mascara corretamente na carga, então a escolha depende do que o sistema a jusante espera.

Exemplo

Um limite básico TextEdit a uma coluna de strings.

Exemplo de reação
Exemplo de Blazor
React TypeScript
Razor

Opções de configuração

Use os controles abaixo para explorar as propriedades disponíveis.

Exemplo de reação
Exemplo de Blazor
Somente leitura? Obrigatório? Deficiente? CorE-mailNúmeroSenhaBuscaTelTextoURL
React TypeScript
Razor

Presets de máscara

Escolha uma máscara no menu suspenso e digite no campo para ver o uso de máscaras ao vivo, seguro para carinhos. Cada preset se junta Mask a um Pattern ou AllowedPattern. Desative o valor mascarado para comparar o que é mantido na coluna — a leitura abaixo do campo reflete o valor armazenado em tempo real.

Exemplo de reação
Exemplo de Blazor
Nenhum (texto simples)Telefone — (000) 000-0000SSN — 000-00-0000Cartão de crédito — 0000 0000 0000 0000ZIP+4 — 00000-0000Apenas letras — [A-Za-z] Armazene o valor mascarado

Valor armazenado:

React TypeScript
Razor
React Blazor

TextEdit Classe

Parâmetros

Nome
Tipo
Padrão
Descrição
AllowedPatternstring?
Por caractere permite regex para MaskMode.Regex (ex. : [A-Za-z]).
Autocompletebool
False
Ativa o autocomplete do navegador para a edição de texto.
ChildContentRenderFragment?
Conteúdo filho do componente
ColumnName*string
Nome lógico da coluna para vincular o editor a partir do registro da tabela.
Descriptionstring?
Descrição será exibida na dica de ferramenta.
Disabledbool?
Caso o editor esteja desativado.
DisplayLabelWhenAvailablebool
True
Especifica se deve exibir uma lable, se disponível.
DisplayTooltipWhenAvailablebool
True
Especifica se deve exibir uma dica de ferramenta, se disponível.
DisplayValidationErrorMessagebool
True
Uma mensagem de erro de validação deve ser exibida quando o componente falha na validação?
EndContentRenderFragment?
Conteúdo renderizado no slot final do campo (após a entrada).
Immediatebool
False
Quando true, o editor confirma seu valor a cada tecla (o evento de entrada do DOM) em vez do desfoque (o evento de mudança do DOM). Útil quando múltiplos editores vinculados à mesma coluna devem permanecer sincronizados como o usuário digita. Padrão para false que os consumidores existentes mantenham O comportamento de se comprometer com confusão. Encaminhado para MaskedTextField.Immediate; veja essa propriedade para a nuance de caminho mascarado vs. rápido.
ImmediateDelayint
0
Debounce, em milissegundos, aplicado ao pressionar a tecla quando TextEdit.Immediate é true. Zero (o padrão) faz commits em cada tecla; Valores positivos esperam esse tempo após a última tecla pressionada antes Valor de disparo Alterado. Encaminhado para MaskedTextField.ImmediateDelay.
IsVisiblebool
True
O editor é visível?
Labelstring?
Texto para ser exibido como um rótulo para o editor.
MaskMaskMode
None
Estratégia de mascaramento aplicada ao input. Define para MaskMode.None, que mantém o campo no caminho rápido zero-interop (um campo de texto encadernado simples). Definir para MaskMode.Pattern ou MaskMode.Regex para permitir o uso de máscaras seguras para carets.
MaxLengthint?
Comprimento máximo da corda permitida.
MinLengthint?
Comprimento máximo da corda permitida.
Patternstring?
Template com ranhuras para MaskMode.Pattern (ex. (000) 000-0000).
ReadOnlybool?
O editor deve ser somente leitura.
Requiredbool?
Se o valor for necessário.
Rowsint?
Quando especificado, determina o número de linhas que o controle ocupará.
StartContentRenderFragment?
Conteúdo renderizado no slot inicial do campo (antes da entrada) — um ícone, prefixo, etc.
StoreMaskedValuebool
False
Controle se um valor mascarado é armazenado com ou sem a máscara. Quando true, a coluna armazena o texto mascarado incluindo literais/separadores (por exemplo , (555) 123-4567); quando false (o padrão), ele armazena o valor desmascarado (por exemplo , 5551234567). Não tem efeito quando TextEdit.Mask é MaskMode.None.
TextFieldTypeTextFieldType
Text
Tipo de campo para a edição de texto
Valuestring?
Valor do controle.
Nome: AllowedPattern
Tipo: string?
Descrição: Por caractere permite regex para MaskMode.Regex (ex. : [A-Za-z]).
Nome: Autocomplete
Tipo: bool
Padrão: False
Descrição: Ativa o autocomplete do navegador para a edição de texto.
Nome: ChildContent
Tipo: RenderFragment?
Descrição: Conteúdo filho do componente
Nome: ColumnName*
Tipo: string
Descrição: Nome lógico da coluna para vincular o editor a partir do registro da tabela.
Nome: Description
Tipo: string?
Descrição: Descrição será exibida na dica de ferramenta.
Nome: Disabled
Tipo: bool?
Descrição: Caso o editor esteja desativado.
Nome: DisplayLabelWhenAvailable
Tipo: bool
Padrão: True
Descrição: Especifica se deve exibir uma lable, se disponível.
Nome: DisplayTooltipWhenAvailable
Tipo: bool
Padrão: True
Descrição: Especifica se deve exibir uma dica de ferramenta, se disponível.
Nome: DisplayValidationErrorMessage
Tipo: bool
Padrão: True
Descrição: Uma mensagem de erro de validação deve ser exibida quando o componente falha na validação?
Nome: EndContent
Tipo: RenderFragment?
Descrição: Conteúdo renderizado no slot final do campo (após a entrada).
Nome: Immediate
Tipo: bool
Padrão: False
Descrição: Quando true, o editor confirma seu valor a cada tecla (o evento de entrada do DOM) em vez do desfoque (o evento de mudança do DOM). Útil quando múltiplos editores vinculados à mesma coluna devem permanecer sincronizados como o usuário digita. Padrão para false que os consumidores existentes mantenham O comportamento de se comprometer com confusão. Encaminhado para MaskedTextField.Immediate; veja essa propriedade para a nuance de caminho mascarado vs. rápido.
Nome: ImmediateDelay
Tipo: int
Padrão: 0
Descrição: Debounce, em milissegundos, aplicado ao pressionar a tecla quando TextEdit.Immediate é true. Zero (o padrão) faz commits em cada tecla; Valores positivos esperam esse tempo após a última tecla pressionada antes Valor de disparo Alterado. Encaminhado para MaskedTextField.ImmediateDelay.
Nome: IsVisible
Tipo: bool
Padrão: True
Descrição: O editor é visível?
Nome: Label
Tipo: string?
Descrição: Texto para ser exibido como um rótulo para o editor.
Nome: Mask
Tipo: MaskMode
Padrão: None
Descrição: Estratégia de mascaramento aplicada ao input. Define para MaskMode.None, que mantém o campo no caminho rápido zero-interop (um campo de texto encadernado simples). Definir para MaskMode.Pattern ou MaskMode.Regex para permitir o uso de máscaras seguras para carets.
Nome: MaxLength
Tipo: int?
Descrição: Comprimento máximo da corda permitida.
Nome: MinLength
Tipo: int?
Descrição: Comprimento máximo da corda permitida.
Nome: Pattern
Tipo: string?
Descrição: Template com ranhuras para MaskMode.Pattern (ex. (000) 000-0000).
Nome: ReadOnly
Tipo: bool?
Descrição: O editor deve ser somente leitura.
Nome: Required
Tipo: bool?
Descrição: Se o valor for necessário.
Nome: Rows
Tipo: int?
Descrição: Quando especificado, determina o número de linhas que o controle ocupará.
Nome: StartContent
Tipo: RenderFragment?
Descrição: Conteúdo renderizado no slot inicial do campo (antes da entrada) — um ícone, prefixo, etc.
Nome: StoreMaskedValue
Tipo: bool
Padrão: False
Descrição: Controle se um valor mascarado é armazenado com ou sem a máscara. Quando true, a coluna armazena o texto mascarado incluindo literais/separadores (por exemplo , (555) 123-4567); quando false (o padrão), ele armazena o valor desmascarado (por exemplo , 5551234567). Não tem efeito quando TextEdit.Mask é MaskMode.None.
Nome: TextFieldType
Tipo: TextFieldType
Padrão: Text
Descrição: Tipo de campo para a edição de texto
Nome: Value
Tipo: string?
Descrição: Valor do controle.

Eventos

Nome
Tipo
Descrição
ValueChangedEventCallback<ColumnValueBase>
Recebe ou define um callback que atualiza o valor vinculado.
Nome: ValueChanged
Tipo: EventCallback<ColumnValueBase>
Descrição: Recebe ou define um callback que atualiza o valor vinculado.

Métodos

Nome
Parâmetros
Tipo
Descrição
GetValidationErrorsList<string>
Retorna uma coleção dos erros de validação atuais.
Nome: GetValidationErrors
Tipo: List<string>
Descrição: Retorna uma coleção dos erros de validação atuais.