DataTypeAttribute Classe

Definição

public ref class DataTypeAttribute : System::ComponentModel::DataAnnotations::ValidationAttribute

[System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Method | System.AttributeTargets.Parameter | System.AttributeTargets.Property, AllowMultiple=false)]
public class DataTypeAttribute : System.ComponentModel.DataAnnotations.ValidationAttribute

[System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Property, AllowMultiple=false)]
public class DataTypeAttribute : System.ComponentModel.DataAnnotations.ValidationAttribute

[<System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Method | System.AttributeTargets.Parameter | System.AttributeTargets.Property, AllowMultiple=false)>]
type DataTypeAttribute = class
    inherit ValidationAttribute

[<System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Property, AllowMultiple=false)>]
type DataTypeAttribute = class
    inherit ValidationAttribute

Public Class DataTypeAttribute
Inherits ValidationAttribute

Herança

Object

Attribute

ValidationAttribute

DataTypeAttribute

Derivado

System.ComponentModel.DataAnnotations.CreditCardAttribute

System.ComponentModel.DataAnnotations.EmailAddressAttribute

System.ComponentModel.DataAnnotations.EnumDataTypeAttribute

System.ComponentModel.DataAnnotations.FileExtensionsAttribute

System.ComponentModel.DataAnnotations.PhoneAttribute

Mais…

Atributos

AttributeUsageAttribute

Exemplos

O exemplo seguinte utiliza o DataTypeAttribute atributo para personalizar a visualização do campo de dados Endereço de Email. Os endereços de email são mostrados como hiperligações em vez de simples texto, que é o que a Dynamic Data inferiria a partir do tipo de dado intrínseco. O código de exemplo está dividido em três partes e executa os seguintes passos:

• Implementa uma classe parcial de metadados e a classe de metadados associada.

• Na classe de metadados associada, aplica-se o DataTypeAttribute atributo ao campo de dados Endereço de Email, especificando o EmailAddress valor enumerado. Isto indica ao modelo de campo Text.ascx que deve personalizar a visualização dos endereços de email.

• Modifica o modelo de campo Text.ascx para personalizar a visualização dos campos de dados Endereço de Email.

using System;
using System.Web.DynamicData;
using System.ComponentModel.DataAnnotations;

[MetadataType(typeof(CustomerMetaData))]
public partial class Customer
{
}

public class CustomerMetaData
{

    // Add type information.
    [DataType(DataType.EmailAddress)]
    public object EmailAddress;
}

Imports System.Web.DynamicData
Imports System.ComponentModel.DataAnnotations

<MetadataType(GetType(CustomerMetadata))> _
Partial Public Class Customer


End Class

Public Class CustomerMetadata

    ' Add type information.
    <DataType(DataType.EmailAddress)> _
    Public EmailAddress As Object

End Class

<%@ Control Language="C#" 
CodeFile="Text.ascx.cs" Inherits="TextField" %>

<!-- Removed, evaluated in the code behind.
<%# FieldValueString %> -->

<%@ Control Language="VB" 
  CodeFile="Text.ascx.vb" Inherits="TextField" %>

<!-- Removed, evaluated in the code behind.
<%# FieldValueString %> -->

using System;
using System.Linq;
using System.Web.UI.WebControls;
using System.Web.DynamicData;
using System.ComponentModel.DataAnnotations;

public partial class TextField : 
    System.Web.DynamicData.FieldTemplateUserControl {

    protected override void OnDataBinding(EventArgs e)
    {
        base.OnDataBinding(e);
        bool processed = false;
        var metadata = MetadataAttributes.OfType
            <DataTypeAttribute>().FirstOrDefault();
        if (metadata != null)
        {
            if (metadata.DataType == DataType.EmailAddress)
            {
                if (!string.IsNullOrEmpty(FieldValueString))
                {
                    processed = true;
                    HyperLink hyperlink = new HyperLink();
                    hyperlink.Text = FieldValueString;
                    hyperlink.NavigateUrl = "mailto:" + FieldValueString;
                    Controls.Add(hyperlink);
                }
            }
        }
        if (!processed)
        {
            Literal literal = new Literal();
            literal.Text = FieldValueString;
            Controls.Add(literal);
        }
    }
}

Imports System.Linq
Imports System.Web.UI.WebControls
Imports System.Web.DynamicData
Imports System.ComponentModel.DataAnnotations

Partial Public Class TextField
    Inherits System.Web.DynamicData.FieldTemplateUserControl

    Protected Overloads Overrides Sub OnDataBinding(ByVal e As EventArgs)
        MyBase.OnDataBinding(e)
        Dim processed As Boolean = False
        Dim metadata As DataTypeAttribute = _
           MetadataAttributes.OfType(Of DataTypeAttribute)().FirstOrDefault()
        If metadata IsNot Nothing Then
            If metadata.DataType = DataType.EmailAddress Then
                If Not String.IsNullOrEmpty(FieldValueString) Then
                    processed = True
                    Dim hyperlink As New HyperLink()
                    hyperlink.Text = FieldValueString
                    hyperlink.NavigateUrl = "mailto:" + FieldValueString
                    Controls.Add(hyperlink)
                End If
            End If
        End If
        If Not processed Then
            Dim literal As New Literal()
            literal.Text = FieldValueString
            Controls.Add(literal)
        End If
    End Sub

End Class

Para compilar e executar o código de exemplo, precisa do seguinte:

• Qualquer edição do Visual Studio 2010 ou posterior.

• A base de dados de exemplos AdventureWorksLT. Para informações sobre como descarregar e instalar a base de dados de exemplos SQL Server, consulte Microsoft SQL Server Product Samples: Database no GitHub. Certifica-te de que instalas a versão correta da base de dados de exemplo para a versão do SQL Server que estás a usar.

• Um site orientado por dados. Isto permite-lhe criar um contexto de dados para a base de dados e criar a classe que contém o campo de dados para personalizar. Para obter mais informações, veja Walkthrough: Creating a New Dynamic Data Web Site using Scaffolding.

Observações

O DataTypeAttribute atributo permite-lhe marcar campos usando um tipo mais específico do que o tipo intrínseco da base de dados. O nome do tipo é selecionado a partir do DataType tipo de enumeração. Por exemplo, um campo de dados em cadeia que contém endereços de email pode ser especificado como o EmailAddress tipo. Esta informação é então acedida pelos templates de campo para modificar a forma como o campo de dados é processado.

Usas o DataTypeAttribute atributo pelas seguintes razões:

• Para fornecer informação adicional de tipo para um campo de dados. Faz-se isto aplicando o DataTypeAttribute atributo a um campo de dados no modelo de dados e especificando o nome adicional do tipo da DataType enumeração. O modelo de campo que processa o campo de dados pode aceder a esta informação adicional sobre o tipo de metadados para determinar como processar o campo. Por exemplo, o modelo de campo de texto pode gerar hiperligações para endereços de email cujo tipo intrínseco é String.

• Associar um modelo de campo personalizado a um campo de dados. O modelo de campo personalizado especificado será então usado para processar o campo de dados. Isto é uma alternativa ao uso do UIHintAttribute atributo.

Quando aplica o DataTypeAttribute atributo a um campo de dados, deve fazer o seguinte:

• Segue as regras de utilização de atributos.

• Implemente a classe de metadados que contém os campos de dados aos quais pretende aplicar o atributo.

• Emitir erros de validação conforme apropriado.

Para mais informações, consulte ASP.NET Diretrizes de Dados Dinâmicos.

Ver também

• ValidationAttribute
• UIHintAttribute
• DataType
• AttributeUsageAttribute
• AttributeTargets
• Como: Personalizar a Aparência e o Comportamento do Campo de Dados para Tipos de Dados Não Intrínsecos no Modelo de Dados
• Extensão dos Metadados Usando Atributos