XmlElementAttribute.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.
Obtém ou define um valor que indica se deve XmlSerializer serializar um membro definido como null uma etiqueta vazia com o xsi:nil atributo definido em 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 BooleanValor de Propriedade
true se o XmlSerializer gerar o xsi:nil atributo; caso contrário, false.
Exemplos
O exemplo seguinte mostra um campo com o XmlElementAttribute aplicado a ele, e a IsNullable propriedade definida para false.
public class MyClass
{
[XmlElement(IsNullable = false)]
public string Group;
}
Public Class MyClass1
<XmlElement(IsNullable := False)> Public Group 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, 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 chamado MyStringArray para null, gera XmlSerializer o seguinte código XML.
<MyStringArray xsi:nil = "true" />
Se a IsNullable propriedade for false, nenhum elemento XML é gerado para membros de classe que foram definidos como null.
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. Além disso, não pode definir esta propriedade para false tipos de valor nulo. Quando tais tipos são null, serão serializados definindo xsi:nil para true.
