XmlElementAttribute.IsNullable Propriété

Définition

Espace de noms:

System.Xml.Serialization

Assemblys:

netstandard.dll, System.Xml.ReaderWriter.dll

Source:

XmlElementAttribute.cs

Obtient ou définit une valeur qui indique si le XmlSerializer membre doit sérialiser un membre défini null sur une balise vide avec l’attribut xsi:nil défini sur 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 l’attribut XmlSerializerxsi:nil génère ; sinon, false.

Exemples

L’exemple suivant montre un champ avec l’application XmlElementAttribute à celui-ci et la IsNullable propriété définie sur false.

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

Public Class MyClass1
    <XmlElement(IsNullable := False)> Public Group 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, XML Schema Part 1 : Structures.

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

<MyStringArray xsi:nil = "true" />

Si la IsNullable propriété est , aucun élément XML n’est falsegénéré pour les membres de classe qui ont été définis nullsur .

Note

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. En outre, vous ne pouvez pas définir cette propriété false pour les types de valeurs nullables. Lorsque de tels types sont null, ils sont sérialisés en définissant xsi:nil sur true.