XmlElementAttribute.IsNullable-Eigenschaft

Artikel
08/20/2007

Ruft einen Wert ab, der angibt, ob XmlSerializer einen Member, der auf NULL (Nothing in Visual Basic) festgelegt ist, als leeres Tag, dessen 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 XmlElementAttribute
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 für Klassenmember generiert, die auf NULL (Nothing in Visual Basic) festgelegt wurden, 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. Darüber hinaus können Sie diese Eigenschaft für NULL-fähige Werttypen nicht auf false festlegen. Wenn solche Typen NULL (Nothing in Visual Basic) sind, werden sie serialisiert, indem xsi:nil auf true festlegt wird.

Beispiel

Im folgenden Beispiel wird ein Feld veranschaulicht, auf das das XmlElementAttribute angewendet wurde und dessen IsNullable-Eigenschaft auf false festgelegt ist.

Public Class MyClass1
    <XmlElement(IsNullable := False)> Public Group As String
End Class

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

public ref class MyClass
{
public:

   [XmlElement(IsNullable=false)]
   String^ Group;
};

public class MyClass
{
    /** @attribute XmlElement(IsNullable = false)
     */
    public String group;
} //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

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

Freigeben über