XmlArrayAttribute.IsNullable Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Recebe ou define um valor que indica se deve XmlSerializer serializar um membro como uma etiqueta XML vazia com o xsi:nil atributo definido como 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
Valor de Propriedade
true se o XmlSerializer gerar o xsi:nil atributo; caso contrário, false.
Exemplos
O exemplo seguinte contém dois arrays: um com a IsNullable propriedade definida para true, e outro com a IsNullable propriedade definida para false.
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
Observações
A especificação de esquema XML para estruturas permite que um documento XML sinalize explicitamente que o conteúdo de um elemento está em falta. Tal elemento contém o atributo xsi:nil conjunto de true. Para mais informações, consulte a especificação do World Wide Web Consortium intitulada XML Schema Parte 1: Estruturas.
Se a IsNullable propriedade for definida para true, o xsi:nil atributo é gerado para membros de classe que foram definidos como null. Por exemplo, se definir um campo com o nome MyStringArray de null, gera XmlSerializer o seguinte código XML.
<MyStringArray xsi:nil = "true" />
Se a IsNullable propriedade for false, não é gerado nenhum elemento XML.
Note
Não pode aplicar a IsNullable propriedade a um membro tipado como tipo de valor porque um tipo de valor não pode conter null.