XmlElementAttribute.IsNullable Propriedade

Definição

Namespace:

System.Xml.Serialization

Assemblies:

netstandard.dll, System.Xml.ReaderWriter.dll

Origem:

XmlElementAttribute.cs

Obtém ou define um valor que indica se deve XmlSerializer serializar um membro definido null como uma marca 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 da propriedade

Boolean

true se o XmlSerializer atributo for gerado 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 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 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, 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 chamado MyStringArraynull, o XmlSerializer código XML será gerado a seguir.

<MyStringArray xsi:nil = "true" />

Se a IsNullable propriedade for false, nenhum elemento XML será gerado para membros de 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.