DataContractAttribute.Name Properti

Definisi

Ruang nama:

System.Runtime.Serialization

Rakitan:

netstandard.dll, System.Runtime.Serialization.Primitives.dll

Sumber:

DataContractAttribute.cs

Mengambil atau menetapkan nama kontrak data untuk tipe tersebut.

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

Nilai Properti

String

Nama lokal kontrak data. Defaultnya adalah nama kelas tempat atribut diterapkan.

Keterangan

Properti Name digunakan untuk memberikan nama ke kontrak data, yang merupakan nama jenis dalam skema XML. Untuk informasi selengkapnya, lihat Nama Kontrak Data.

Secara default, nama kontrak data adalah nama jenis yang DataContractAttribute diterapkan. Namun, mungkin ada alasan untuk mengubah nama default ini. Salah satu alasannya adalah mengizinkan jenis yang ada untuk memproses data yang harus sesuai dengan kontrak data yang ada. Misalnya, ada jenis bernama Person tetapi kontrak data, yang diwujudkan dalam skema XML, mengharuskan nama tersebut menjadi Customer. Kontrak dapat dipenuhi dengan mengatur nilai properti ke Customer.

Alasan kedua adalah untuk memungkinkan pembuatan nama yang tidak valid sebagai nama jenis. Misalnya, jika kontrak data menuntut nama yang tidak diizinkan sebagai nama jenis, atur nilai properti ke nama yang tidak diizinkan tersebut. Misalnya, string "$value" tidak diizinkan sebagai nama jenis tetapi diizinkan sebagai Name nilai properti.