XmlArrayAttribute.IsNullable Proprietà

Definizione

Ottiene o imposta un valore che indica se XmlSerializer deve serializzare un membro come un tag XML vuoto con l'attributo xsi:nil impostato su true.

public bool IsNullable { get; set; }

Valore della proprietà

true se l'attributo xsi:nil viene generato dalla classe XmlSerializer; in caso contrario, false.

Esempio

L'esempio seguente contiene due matrici: una con la IsNullable proprietà impostata su truee un'altra con la IsNullable proprietà impostata su false.

public class MyClass
{
   [XmlArray (IsNullable = true)]
   public string [] IsNullableIsTrueArray;

   [XmlArray (IsNullable = false)]
   public string [] IsNullableIsFalseArray;
}

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 intitolata 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.

Nota

Non è possibile applicare la IsNullable proprietà a un membro tipizzato come tipo valore perché un tipo valore non può contenere null.

Si applica a

Prodotto Versioni
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1
UWP 10.0