XmlArrayAttribute.IsNullable Özellik

Tanım

Ad Alanı:

System.Xml.Serialization

Bütünleştirilmiş Kod:

System.Xml.XmlSerializer.dll

Bütünleştirilmiş Kod:

System.Xml.dll

Bütünleştirilmiş Kod:

netstandard.dll

öğesinin bir üyeyiXmlSerializer, özniteliği olarak ayarlanmış trueboş bir XML etiketi olarak serileştirmesi xsi:nil gerekip gerekmediğini 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ış.false

public ref class MyClass
{
public:

   [XmlArray(IsNullable=true)]
   array<String^>^IsNullableIsTrueArray;

   [XmlArray(IsNullable=false)]
   array<String^>^IsNullableIsFalseArray;
};

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 ayarlanmış trueözniteliğini xsi:nil içerir. Daha fazla bilgi için bkz. XML Şeması Bölüm 1: Yapılar başlıklı World Wide Web Konsorsiyum belirtimi.

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

<MyStringArray xsi:nil = "true" />  

IsNullable özelliği isefalse, hiçbir XML öğesi oluşturulmaz.

Not

Bir değer türü içeremediğindennull, özelliğini değer türü olarak yazılan üyeye uygulayamazsınızIsNullable.