XmlElementAttribute.IsNullable Properti

Definisi

Ruang nama:

System.Xml.Serialization

Rakitan:

netstandard.dll, System.Xml.ReaderWriter.dll

Sumber:

XmlElementAttribute.cs

Mendapatkan atau menetapkan nilai yang menunjukkan apakah XmlSerializer harus menserialisasikan anggota yang diatur ke null sebagai tag 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

true XmlSerializer jika menghasilkan xsi:nil atribut; jika tidak, false.

Contoh

Contoh berikut menunjukkan bidang dengan XmlElementAttribute diterapkan ke bidang tersebut, dan properti diatur IsNullable ke false.

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

Public Class MyClass1
    <XmlElement(IsNullable := False)> Public Group 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, 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 untuk anggota kelas yang telah diatur ke null.

Nota

Anda tidak dapat menerapkan properti ke IsNullable anggota yang dititik sebagai tipe nilai karena tipe nilai tidak boleh berisi null. Selain itu, Anda tidak dapat mengatur properti ini ke false untuk tipe nilai nullable. Ketika jenis tersebut adalah null, jenis tersebut akan diserialisasikan dengan mengatur xsi:nil ke true.