XmlArrayAttribute.IsNullable Propriedade
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define um valor que indica se o XmlSerializer deve serializar um membro como uma marca de XML vazia com o atributo xsi:nil definido como 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 Booleantrue se o XmlSerializer gera o atributo xsi:nil; caso contrário, false.
O exemplo a seguir contém duas matrizes: uma com a IsNullable propriedade definida como true, e outra com a IsNullable propriedade definida como 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
A especificação de esquema XML para estruturas permite que um documento XML sinalize explicitamente que o conteúdo de um elemento está ausente. Esse elemento contém o conjunto de atributos xsi:nil como true. Para obter mais informações, consulte a especificação do World Wide Web Consortium intitulada Esquema XML Parte 1: Estruturas.
Se a IsNullable propriedade estiver definida como true, o xsi:nil atributo será gerado para membros de classe que foram definidos como null. Por exemplo, se você definir um campo nomeado MyStringArray como null, o XmlSerializer código XML a seguir será gerado.
<MyStringArray xsi:nil = "true" />
Se a IsNullable propriedade for false, nenhum elemento XML será gerado.
Observação
Não é possível aplicar a IsNullable propriedade a um membro digitado como um tipo de valor porque um tipo de valor não pode conter null.
| Produto | Versões |
|---|---|
| .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 |
| .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 |
| .NET Standard | 2.0, 2.1 |
| UWP | 10.0 |