DataTypeAttribute Classe

Définition

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

Héritage

Object

Attribute

ValidationAttribute

DataTypeAttribute

Dérivé

System.ComponentModel.DataAnnotations.CreditCardAttribute

System.ComponentModel.DataAnnotations.EmailAddressAttribute

System.ComponentModel.DataAnnotations.EnumDataTypeAttribute

System.ComponentModel.DataAnnotations.FileExtensionsAttribute

System.ComponentModel.DataAnnotations.PhoneAttribute

Plus…

Attributs

AttributeUsageAttribute

Exemples

L’exemple suivant utilise l’attribut DataTypeAttribute pour personnaliser l’affichage du champ de données EmailAddress. Les adresses e-mail sont affichées sous forme de liens hypertexte au lieu de texte simple, ce qui est ce que Dynamic Data déduit à partir du type de données intrinsèque. L’exemple de code se présente en trois parties et effectue les étapes suivantes :

• Il implémente une classe partielle de métadonnées et la classe de métadonnées associée.

• Dans la classe de métadonnées associée, il applique l’attribut DataTypeAttribute au champ de données EmailAddress en spécifiant la EmailAddress valeur énumérée. Cela indique au modèle de champ Text.ascx qu’il doit personnaliser l’affichage des adresses e-mail.

• Il modifie le modèle de champ Text.ascx pour personnaliser l’affichage des champs de données EmailAddress.

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

Pour compiler et exécuter l’exemple de code, vous avez besoin des éléments suivants :

• N’importe quelle édition de Visual Studio 2010 ou version ultérieure.

• Exemple de base de données AdventureWorksLT. Pour plus d’informations sur le téléchargement et l’installation de l’exemple de base de données SQL Server, consultez Exemples de produits Microsoft SQL Server : base de données sur GitHub. Veillez à installer la version correcte de l’exemple de base de données pour la version de SQL Server que vous exécutez.

• Site Web piloté par les données. Cela vous permet de créer un contexte de données pour la base de données et de créer la classe qui contient le champ de données à personnaliser. Pour plus d'informations, consultez Walkthrough: Creating a New Dynamic Data Web Site using Scaffolding.

Remarques

L’attribut DataTypeAttribute vous permet de marquer des champs à l’aide d’un type plus spécifique que le type intrinsèque de base de données. Le nom de type est sélectionné dans le type d’énumération DataType . Par exemple, un champ de données de chaîne qui contient des adresses e-mail peut être spécifié comme EmailAddress type. Ces informations sont ensuite accessibles par les modèles de champ pour modifier la façon dont le champ de données est traité.

Vous utilisez l’attribut DataTypeAttribute pour les raisons suivantes :

• Pour fournir des informations de type supplémentaires pour un champ de données. Pour ce faire, appliquez l’attribut DataTypeAttribute à un champ de données dans le modèle de données et spécifiez le nom de type supplémentaire de l’énumération DataType . Le modèle de champ qui traite le champ de données peut accéder à ces informations de type de métadonnées supplémentaires pour déterminer comment traiter le champ. Par exemple, le modèle de champ de texte peut générer des liens hypertexte pour les adresses e-mail dont le type intrinsèque est String.

• Pour associer un modèle de champ personnalisé à un champ de données. Le modèle de champ personnalisé spécifié sera ensuite utilisé pour traiter le champ de données. Il s’agit d’une alternative à l’utilisation de l’attribut UIHintAttribute .

Lorsque vous appliquez l’attribut DataTypeAttribute à un champ de données, vous devez effectuer les opérations suivantes :

• Suivez les règles d’utilisation des attributs.

• Implémentez la classe de métadonnées qui contient les champs de données auxquels vous souhaitez appliquer l’attribut.

• Émettez des erreurs de validation le cas échéant.

Pour plus d’informations, consultez ASP.NET Instructions relatives aux données dynamiques.

Constructeurs

Propriétés

Méthodes

Implémentations d’interfaces explicites

S’applique à

Voir aussi

• ValidationAttribute
• UIHintAttribute
• DataType
• AttributeUsageAttribute
• AttributeTargets
• Guide pratique pour personnaliser l’apparence et le comportement des champs de données pour les types de données non intrinsèques dans le modèle de données
• Extension des métadonnées à l'aide des attributs