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 XmlSerializer olarak ayarlanmış bir üyeyi null seri hale getirmesi xsi:nil 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 XmlElementAttribute özelliği olarak ayarlanmış IsNullablebir alan false 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 xsi:nilayarlanmış özniteliğini true 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.

Note

Bir değer türü içeremediğindenIsNullable, özelliğini değer türü olarak yazılan üyeye uygulayamazsınıznull. 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.