XmlArrayAttribute.IsNullable Propriété
Définition
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 le XmlSerializer membre doit sérialiser un membre en tant que balise XML 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é
true si l’attribut XmlSerializerxsi:nil génère ; sinon, false.
Exemples
L’exemple suivant contient deux tableaux : un avec la IsNullable propriété définie truesur , et une autre avec la IsNullable propriété définie sur false.
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 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 false, aucun élément XML n’est généré.
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.