DataContractAttribute.Name Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mendapatkan atau mengatur nama kontrak data untuk jenis tersebut.
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
Nilai Properti
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 adalah 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.