XmlArrayAttribute.IsNullable Özellik

Tanım

Ad Alanı:

System.Xml.Serialization

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Xml.XmlSerializer.dll

Kaynak:

XmlArrayAttribute.cs

öğesinin, özniteliği olarak ayarlanmış trueboş bir XML etiketi olarak bir üyeyi seri hale getirmesi xsi:nil gerekip gerekmediğini XmlSerializer belirten bir değer alır veya ayarlar.

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 örnek iki dizi içerir: biri IsNullable özelliği olarak trueayarlanmış, diğeri IsNullable ise özelliği olarak ayarlanmıştır false.

public class MyClass
{
   [XmlArray (IsNullable = true)]
   public string [] IsNullableIsTrueArray;

   [XmlArray (IsNullable = false)]
   public string [] IsNullableIsFalseArray;
}

Public Class MyClass1
    <XmlArray(IsNullable := True)> _
    Public IsNullableIsTrueArray() As String

    <XmlArray(IsNullable := False)> _
    Public IsNullableIsFalseArray() 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. XML Şema Bölüm 1: Yapılar başlıklı World Wide Web Konsorsiyumu belirtimi.

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, 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.