Export (0) Print
Expand All
1 out of 1 rated this helpful - Rate this topic

DataContractAttribute.Name Property

Gets or sets the name of the data contract for the type.

Namespace: System.Runtime.Serialization
Assembly: System.Runtime.Serialization (in system.runtime.serialization.dll)

public:
property String^ Name {
	String^ get ();
	void set (String^ value);
}
/** @property */
public String get_Name ()

/** @property */
public void set_Name (String value)

public function get Name () : String

public function set Name (value : String)

Not applicable.

Property Value

The local name of a data contract. The default is the name of the class that the attribute is applied to.

The Name property is used to give a name to a data contract, which will also be the name of the type in XML schema. For more information, see Data Contract Names.

By default, the name of a data contract is the name of the type that the DataContractAttribute is applied to. However, there may be reasons to change this default name. One reason is to allow an existing type to process data that must conform to an existing data contract. For example, there exists a type named "Person" but the data contract, embodied in an XML schema, requires that the name be "Customer". The contract can be satisfied by setting the property value to "Customer".

A second reason is to allow the generation of names that are invalid as type names. For example, if a data contract demands a name that is not allowable as a type name, set the property value to that disallowed name. For instance, the string "$value" is disallowed as a type name but is allowed as a Name property value.

Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.