DataContractAttribute.Name Özellik

  • Başvuru

Tanım

Ad Alanı:
System.Runtime.Serialization
Bütünleştirilmiş Kod:
System.Runtime.Serialization.Primitives.dll
Bütünleştirilmiş Kod:
System.Runtime.Serialization.dll
Bütünleştirilmiş Kod:
netstandard.dll

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; }
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, veri sözleşmesinin adı uygulandığı türün DataContractAttribute adıdır. Ancak, bu varsayılan adı değiştirmenin nedenleri 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 talep ederse, ö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.

Şunlara uygulanır