XmlArrayAttribute.IsNullable-Eigenschaft

Ruft einen Wert ab, der angibt, ob XmlSerializer einen Member als leeres XML-Tag, bei dem das xsi:nil-Attribut auf true festgelegt ist, serialisieren muss, oder legt diesen fest.

Namespace: System.Xml.Serialization
Assembly: System.Xml (in system.xml.dll)

Syntax

'Declaration
Public Property IsNullable As Boolean
'Usage
Dim instance As XmlArrayAttribute
Dim value As Boolean

value = instance.IsNullable

instance.IsNullable = value

public bool IsNullable { get; set; }

public:
property bool IsNullable {
    bool get ();
    void set (bool value);
}

/** @property */
public boolean get_IsNullable ()

/** @property */
public void set_IsNullable (boolean value)

public function get IsNullable () : boolean

public function set IsNullable (value : boolean)

Eigenschaftenwert

true, wenn XmlSerializer das xsi:nil-Attribut generiert, andernfalls false.

Hinweise

Die XML-Schemaspezifikation für Strukturen ermöglicht es einem XML-Dokument, explizit zu signalisieren, dass der Inhalt eines Elements fehlt. Das Attribut xsi:nil eines solchen Elements ist auf true festgelegt. Weitere Informationen finden Sie in der World Wide Web Consortium-Spezifikation (www.w3.org) "XML Schema Part 1: Structures".

Wenn die IsNullable-Eigenschaft auf true festgelegt ist, wird das xsi:nil-Attribut für Klassenmember generiert, die auf NULL (Nothing in Visual Basic) festgelegt wurden. Wenn Sie z. B. das Feld MyStringArray auf NULL (Nothing in Visual Basic) festlegen, generiert XmlSerializer folgenden XML-Code.

 <MyStringArray xsi:nil = "true" />

Wenn die IsNullable-Eigenschaft false ist, wird kein XML-Element generiert.

Hinweis

Sie können die IsNullable-Eigenschaft nicht einem Member zuweisen, der als Werttyp definiert wurde, da ein Werttyp nicht NULL (Nothing in Visual Basic) enthalten kann.

Beispiel

Im folgenden Beispiel sind zwei Arrays vorhanden: eines, dessen IsNullable-Eigenschaft auf true festgelegt ist, und ein weiteres, dessen IsNullable-Eigenschaft auf false festgelegt ist.

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

    <XmlArray(IsNullable := False)> _
    Public IsNullableIsFalseArray() As String
End Class

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

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

public ref class MyClass
{
public:

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

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

public class MyClass
{
    /** @attribute XmlArray(IsNullable = true)
     */
    public String isNullableIsTrueArray[];

    /** @attribute XmlArray(IsNullable = false)
     */
    public String isNullableIsFalseArray[];
} //MyClass

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

XmlArrayAttribute-Klasse
XmlArrayAttribute-Member
System.Xml.Serialization-Namespace