DataContractAttribute.Name Özellik

Tanım

Ad Alanı:

System.Runtime.Serialization

Bütünleştirilmiş Kod:

System.Runtime.Serialization.Primitives.dll

Kaynak:

DataContractAttribute.cs

Tür için veri sözleşmesinin adını alır veya ayarlar.

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

Özellik Değeri

String

Veri sözleşmesinin yerel adı. Varsayılan, özniteliğin uygulandığı sınıfın adıdır.

Açıklamalar

Name özelliği, XML şemasındaki türün adı olan bir veri sözleşmesine ad vermek için kullanılır. Daha fazla bilgi için bkz. Veri Sözleşmesi Adları.

Varsayılan olarak, bir veri sözleşmesinin adı uygulandığı türün DataContractAttribute adıdır. Ancak, bu varsayılan adı değiştirmek için nedenler olabilir. Bunun bir nedeni, mevcut bir türün mevcut bir veri sözleşmesine uyması gereken verileri işlemesine izin vermektir. Örneğin, adlı Person bir tür vardır, ancak XML şemasında yer alan veri sözleşmesi, adın olmasını Customergerektirir. Özellik değeri Customerolarak ayarlanarak sözleşme karşılanabilir.

İkinci neden, tür adları olarak geçersiz adların oluşturulmasına izin vermektir. Örneğin, bir veri sözleşmesi tür adı olarak izin verilmeyen bir ad isterse, özellik değerini izin verilmeyen ad olarak ayarlayın. Örneğin, "$value" dizesine tür adı olarak izin verilmez ancak özellik değeri olarak Name izin verilir.