DataContractAttribute.Name 属性

定义

命名空间:

System.Runtime.Serialization

程序集:

System.Runtime.Serialization.Primitives.dll

Source:

DataContractAttribute.cs

获取或设置类型的数据协定的名称。

public:
 property System::String ^ Name { System::String ^ get(); void set(System::String ^ value); };

public string? Name { get; set; }

member this.Name : string with get, set

Public Property Name As String

属性值

String

数据协定的本地名称。 默认值是应用了该属性的类的名称。

注解

Name 属性用于为数据协定指定名称，该名称也将成为 XML 架构中类型的名称。 有关详细信息，请参阅 数据协定名称。

默认情况下，数据协定的名称是应用了 DataContractAttribute 的类型的名称。 不过，可能出于某些原因更改此默认名称。 其中一个原因就是使现有类型可以处理必须符合现有数据协定的数据。 例如，有一个名为 Person 的类型，但包含在某个 XML 架构中的数据协定要求该名称为 Customer。 可通过将该属性值设置为 Customer 来满足该协定。

另一个原因是允许生成不能作为类型名的名称。 例如，如果数据协定需要一个不允许作为类型名的名称，则将该属性值设置为这一不允许使用的名称。 例如，不允许使用字符串“$value”作为类型名，但允许使用它作为 Name 属性值。