Partilhar via


XmlElementAttribute.IsNullable Propriedade

Definição

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, set
Public Property IsNullable As Boolean

Valor da propriedade

Boolean

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.

Aplica-se a