XmlArrayAttribute.IsNullable Eigenschaft

Definition

Namespace:

System.Xml.Serialization

Assembly:

System.Xml.XmlSerializer.dll

Quelle:

XmlArrayAttribute.cs

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.

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

Eigenschaftswert

Boolean

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

Beispiele

Das folgende Beispiel enthält zwei Arrays: eines mit festgelegter IsNullable Eigenschaft auf trueund ein weiteres mit festgelegter IsNullable Eigenschaft auf 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

Hinweise

Mit der XML-Schemaspezifikation für Strukturen kann ein XML-Dokument explizit signalisieren, dass der Inhalt eines Elements fehlt. Ein solches Element enthält das Attribut xsi:nil , das auf truefestgelegt ist. Weitere Informationen finden Sie in der Spezifikation des World Wide Web Consortium mit dem Titel XML-Schema Part 1: Structures.

Wenn die IsNullable -Eigenschaft auf truefestgelegt ist, wird das xsi:nil Attribut für Klassenmember generiert, die auf nullfestgelegt wurden. Wenn Sie beispielsweise ein Feld mit dem Namen MyStringArraynullfestlegen, generiert der XmlSerializer den folgenden XML-Code.

<MyStringArray xsi:nil = "true" />  

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

Hinweis

Sie können die IsNullable Eigenschaft nicht auf ein Element anwenden, das als Werttyp eingegeben wurde, da ein Werttyp nicht enthalten nullkann.