DataContractAttribute.Name プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
型のデータ コントラクトの名前を取得または設定します。
public:
property System::String ^ Name { System::String ^ get(); void set(System::String ^ value); };
public string Name { get; set; }
public string? Name { get; set; }
member this.Name : string with get, set
Public Property Name As String
プロパティ値
データ コントラクトのローカル名。 既定値は、属性が適用されるクラスの名前です。
注釈
Name プロパティは、XML スキーマ内の型の名前であるデータ コントラクトに名前を付けるために使用されます。 詳細については、「 データ コントラクト名」を参照してください。
既定では、データ コントラクトの名前は、 DataContractAttribute が適用される型の名前です。 ただし、この既定の名前を変更する理由が考えられる場合があります。 1 つの理由は、既存のデータ コントラクトに準拠する必要があるデータを既存の型で処理できるようにすることです。 たとえば、 Person という名前の型が存在しますが、XML スキーマに組み込まれたデータ コントラクトでは、名前を Customerする必要があります。 プロパティ値を Customer に設定することで、コントラクトを満たすことができます。
2 つ目の理由は、型名として無効な名前の生成を許可するためです。 たとえば、データ コントラクトが型名として許可されていない名前を要求する場合は、プロパティ値をその許可されていない名前に設定します。 たとえば、文字列 "$value" は型名として許可されませんが、 Name プロパティ値として使用できます。