DataTypeAttribute 类

定义

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

继承

Object

Attribute

ValidationAttribute

DataTypeAttribute

派生

System.ComponentModel.DataAnnotations.CreditCardAttribute

System.ComponentModel.DataAnnotations.EmailAddressAttribute

System.ComponentModel.DataAnnotations.EnumDataTypeAttribute

System.ComponentModel.DataAnnotations.FileExtensionsAttribute

System.ComponentModel.DataAnnotations.PhoneAttribute

更多…

属性

AttributeUsageAttribute

示例

以下示例使用 DataTypeAttribute 属性自定义 EmailAddress 数据字段的显示。 电子邮件地址显示为超链接而不是简单文本，动态数据将从内部数据类型推断出来。 示例代码分为三部分，执行以下步骤：

• 它实现元数据分部类和关联的元数据类。

• 在关联的元数据类中，它通过指定EmailAddress枚举值将 DataTypeAttribute 属性应用于 EmailAddress 数据字段。 这向 Text.ascx 字段模板指示它应自定义电子邮件地址的显示。

• 它修改 Text.ascx 字段模板以自定义 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

若要编译和运行示例代码，需要以下各项：

• 任何版本的 Visual Studio 2010 或更高版本。

• AdventureWorksLT 示例数据库。 有关如何下载和安装 SQL Server 示例数据库的信息，请参阅 Microsoft SQL Server 产品示例：GitHub 上的数据库。 请确保为正在运行的 SQL Server 版本安装正确版本的示例数据库。

• 数据驱动的网站。 这使你可以为数据库创建数据上下文，并创建包含要自定义的数据字段的类。 有关详细信息，请参阅 Walkthrough: Creating a New Dynamic Data Web Site using Scaffolding。

注解

通过 DataTypeAttribute 特性，可以使用比数据库内部类型更具体的类型来标记字段。 类型名称是从枚举类型中选择的 DataType 。 例如，可以将包含电子邮件地址的字符串数据字段指定为 EmailAddress 类型。 然后，字段模板会访问此信息，以修改数据字段的处理方式。

使用 DataTypeAttribute 属性的原因如下：

• 为数据字段提供其他类型信息。 为此， DataTypeAttribute 可以将 属性应用于数据模型中的数据字段，并从枚举中指定其他类型名称 DataType 。 处理数据字段的字段模板可以访问此附加元数据类型信息，以确定如何处理字段。 例如，文本字段模板可以为其内部类型为 String的电子邮件地址生成超链接。

• 将自定义字段模板与数据字段相关联。 然后，将使用指定的自定义字段模板来处理数据字段。 这是使用 属性的 UIHintAttribute 替代方法。

将 DataTypeAttribute 属性应用于数据字段时，必须执行以下操作：

• 遵循属性使用规则。

• 实现元数据类，该类包含要向其应用特性的数据字段。

• 根据需要发出验证错误。

有关详细信息，请参阅 ASP.NET 动态数据指南。

构造函数

属性

方法

显式接口实现

适用于

另请参阅

• ValidationAttribute
• UIHintAttribute
• DataType
• AttributeUsageAttribute
• AttributeTargets
• 如何：为数据模型中的非内部数据类型自定义数据字段外观和行为
• 利用特性扩展元数据