XmlElementAttribute.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 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, setPublic Property IsNullable As BooleanValeur de propriété
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.