XmlElementAttribute.IsNullable Özellik

Tanım

Ad Alanı:

System.Xml.Serialization

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Xml.ReaderWriter.dll

Kaynak:

XmlElementAttribute.cs

özniteliği olarak ayarlanmış boş bir etiket xsi:nil olarak ayarlanmış bir üyeyi XmlSerializer seri hale getirmesi null gerekip gerekmediğini belirten bir değer alır veya ayarlartrue.

public:
 property bool IsNullable { bool get(); void set(bool value); };

public bool IsNullable { get; set; }

member this.IsNullable : bool with get, set

Public Property IsNullable As Boolean

Özellik Değeri

Boolean

true özniteliğini XmlSerializer oluşturursa xsi:nil ; değilse, false.

Örnekler

Aşağıdaki örnekte, uygulanan ve IsNullable özelliği olarak ayarlanmış falsebir alan XmlElementAttribute gösterilmektedir.

public class MyClass
{
   [XmlElement(IsNullable = false)]
   public string Group;
}

Public Class MyClass1
    <XmlElement(IsNullable := False)> Public Group As String
End Class

Açıklamalar

Yapıların XML şema belirtimi, XML belgesinin bir öğenin içeriğinin eksik olduğunu açıkça belirtmesine olanak tanır. Böyle bir öğe olarak trueayarlanmış özniteliğini xsi:nil içerir. Daha fazla bilgi için bkz. World Wide Web Konsorsiyumu belirtimi, XML Şema Bölüm 1: Yapılar.

IsNullable özelliği olarak truexsi:nil ayarlanırsa, özniteliği olarak ayarlanmış nullsınıf üyeleri için oluşturulur. Örneğin, adlı MyStringArraynullbir alan ayarlarsanız, aşağıdaki XmlSerializer XML kodunu oluşturur.

<MyStringArray xsi:nil = "true" />

IsNullable özelliği isefalse, olarak ayarlanmış nullsınıf üyeleri için hiçbir XML öğesi oluşturulmaz.

Uyarı

Bir değer türü içeremediğindennull, özelliğini değer türü olarak yazılan üyeye uygulayamazsınızIsNullable. Ayrıca, null atanabilir değer türleri için bu özelliği false olarak ayarlayamazsınız. Bu tür türler nullolduğunda, olarak ayarlanarak xsi:niltrueserileştirilir.