XmlElementAttribute.IsNullable Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene o imposta un valore che indica se XmlSerializer deve serializzare un membro impostato su null come un tag vuoto con l'attributo xsi:nil impostato su 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 BooleanValore della proprietà
true se l'attributo xsi:nil viene generato dalla classe XmlSerializer; in caso contrario, false.
Esempio
Nell'esempio seguente viene illustrato un campo con l'oggetto XmlElementAttribute applicato e la IsNullable proprietà impostata su 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
Commenti
La specifica XML Schema per le strutture consente a un documento XML di segnalare in modo esplicito che il contenuto di un elemento non è presente. Tale elemento contiene l'attributo xsi:nil impostato su true. Per altre informazioni, vedere la specifica del World Wide Web Consortium, XML Schema Part 1: Structures.
Se la IsNullable proprietà è impostata su true, l'attributo xsi:nil viene generato per i membri della classe che sono stati impostati su null. Ad esempio, se si imposta un campo denominato MyStringArray su null, viene XmlSerializer generato il codice XML seguente.
<MyStringArray xsi:nil = "true" />
Se la IsNullable proprietà è false, non viene generato alcun elemento XML per i membri della classe impostati su null.
Nota
Non è possibile applicare la IsNullable proprietà a un membro tipizzato come tipo valore perché un tipo valore non può contenere null. Inoltre, non è possibile impostare questa proprietà su false per i tipi valore nullable. Quando questi tipi sono null, verranno serializzati impostando xsi:nil su true.