XmlElementAttribute.IsNullable Propriété

Référence

Définition

Espace de noms:: System.Xml.Serialization

Assembly:: System.Xml.XmlSerializer.dll

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Obtient ou définit une valeur qui indique si XmlSerializer doit sérialiser un membre dont la valeur est null comme balise vide avec l'attribut xsi:nil ayant 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 montre un champ avec l’application XmlElementAttribute , et la IsNullable propriété définie sur false.

public ref class MyClass
{
public:

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

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 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é pour les membres de classe qui ont été définis sur null.

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

S’applique à

Partager via