XmlArrayAttribute.IsNullable Propriété

Définition

Espace de noms:

System.Xml.Serialization

Assembly:

System.Xml.XmlSerializer.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

Obtient ou définit une valeur qui indique si le XmlSerializer doit sérialiser un membre comme balise XML vide lorsque l'attribut xsi:nil a la valeur 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

Valeur de propriété

Boolean

true si XmlSerializer génère l'attribut xsi:nil ; false sinon.

Exemples

L’exemple suivant contient deux tableaux : un avec la IsNullable propriété définie truesur , et un autre avec la IsNullable propriété définie falsesur .

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

Remarques

La spécification de schéma XML pour les structures permet à un document XML de signaler explicitement que le contenu d’un élément est manquant. Un tel élément contient l’attribut xsi:nil défini sur true. Pour plus d’informations, consultez la spécification World Wide Web Consortium intitulée Xml Schema Part 1: Structures.

Si la IsNullable propriété est définie sur true, l’attribut xsi:nil est généré pour les membres de classe qui ont été définis sur null. Par exemple, si vous définissez un champ nommé MyStringArray nullsur , le XmlSerializer code XML suivant est généré.

<MyStringArray xsi:nil = "true" />  

Si la IsNullable propriété est false, aucun élément XML n’est généré.

Notes

Vous ne pouvez pas appliquer la IsNullable propriété à un membre typé en tant que type valeur, car un type valeur ne peut pas contenir null.