XmlElementAttribute.IsNullable Propriedade
Definição
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 definido como null como uma marca 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 BooleanValor da propriedade
true se o XmlSerializer gera o atributo xsi:nil; caso contrário, false.
Exemplos
O exemplo a seguir mostra um campo com o XmlElementAttribute aplicado a ele e a IsNullable propriedade definida como false.
public ref class MyClass
{
public:
[XmlElement(IsNullable=false)]
String^ Group;
};
public class MyClass
{
[XmlElement(IsNullable = false)]
public string Group;
}
Public Class MyClass1
<XmlElement(IsNullable := False)> Public Group As String
End Class
Comentários
A especificação do 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 atributo xsi:nil definido como true. Para obter mais informações, consulte a especificação world wide web consortium, XML Schema Part 1: Structures.
Se a IsNullable propriedade estiver definida como true, o xsi:nil atributo será gerado para os membros da classe que foram definidos como null. Por exemplo, se você definir um campo chamado MyStringArray 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 para os membros da classe que foram definidos como null.
Observação
Você não pode aplicar a IsNullable propriedade a um membro digitado como um tipo de valor porque um tipo de valor não pode conter null. Além disso, você não pode definir essa propriedade para false tipos de valor anuláveis. Quando esses tipos estiverem null, eles serão serializados definindo xsi:nil como true.