XmlArrayAttribute.IsNullable Proprietà
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 come un tag XML 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, set
Public Property IsNullable As Boolean
true
se l'attributo xsi:nil
viene generato dalla classe XmlSerializer; in caso contrario, false
.
L'esempio seguente contiene due matrici: una con la IsNullable proprietà impostata su true
e un'altra con la IsNullable proprietà impostata su false
.
public ref class MyClass
{
public:
[XmlArray(IsNullable=true)]
array<String^>^IsNullableIsTrueArray;
[XmlArray(IsNullable=false)]
array<String^>^IsNullableIsFalseArray;
};
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
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
.
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 |
Feedback su .NET
.NET è un progetto di open source. Selezionare un collegamento per fornire feedback: