XmlArrayAttribute.IsNullable Properti

Definisi

Ruang nama:

System.Xml.Serialization

Rakitan:

System.Xml.XmlSerializer.dll

Sumber:

XmlArrayAttribute.cs

Mendapatkan atau menetapkan nilai yang menunjukkan apakah XmlSerializer harus menserialisasikan anggota sebagai tag XML kosong dengan atribut yang xsi:nil diatur ke true.

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

Nilai Properti

Boolean

trueXmlSerializer jika menghasilkan xsi:nil atribut ; jika tidak, false.

Contoh

Contoh berikut berisi dua array: satu dengan properti diatur IsNullable ke true, dan satu lagi dengan properti diatur IsNullable ke 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

Keterangan

Spesifikasi skema XML untuk struktur memungkinkan dokumen XML untuk secara eksplisit memberi sinyal bahwa konten elemen hilang. Elemen seperti itu berisi atribut xsi:nil yang diatur ke true. Untuk informasi selengkapnya, lihat spesifikasi World Wide Web Consortium berjudul Skema XML Bagian 1: Struktur.

IsNullable Jika properti diatur ke true, xsi:nil atribut dihasilkan untuk anggota kelas yang telah diatur ke null. Misalnya, jika Anda mengatur bidang bernama MyStringArray ke null, XmlSerializer menghasilkan kode XML berikut.

<MyStringArray xsi:nil = "true" />  

IsNullable Jika properti adalah false, tidak ada elemen XML yang dihasilkan.

Catatan

Anda tidak dapat menerapkan properti ke IsNullable anggota yang di ketik sebagai tipe nilai karena tipe nilai tidak boleh berisi null.