XmlArrayAttribute.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 membro deve serializar como uma marca 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, setPublic Property IsNullable As BooleanValor da propriedade
true se o XmlSerializer atributo for gerado xsi:nil ; caso contrário, false.
Exemplos
O exemplo a seguir contém duas matrizes: uma com a IsNullable propriedade definida como true, e outra com a IsNullable propriedade definida como 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
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 intitulada 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.
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.
