XmlElementAttribute.IsNullable Propriété

Définition

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 le XmlElementAttribute appliqué, et la IsNullable propriété a la valeur 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é a la valeur true , l' xsi:nil attribut est généré pour les membres de classe qui ont la valeur null . Par exemple, si vous définissez un champ nommé MyStringArray sur null , le XmlSerializer génère le code XML suivant.

<MyStringArray xsi:nil = "true" />  

Si la IsNullable propriété a la false valeur, 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 affecter à cette propriété la false valeur pour les types valeur Nullable. Lorsque ces types sont null , ils sont sérialisés en affectant xsi:nil à la valeur true .

S’applique à