XmlArrayAttribute.IsNullable Eigenschaft

Referenz

Definition

Namespace:: System.Xml.Serialization

Assembly:: System.Xml.XmlSerializer.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Quelle:: XmlArrayAttribute.cs

Quelle:: XmlArrayAttribute.cs

Quelle:: XmlArrayAttribute.cs

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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.

Gilt für:

Freigeben über