XmlElementAttribute.IsNullable Propiedad

Definición

Espacio de nombres:

System.Xml.Serialization

Ensamblado:

System.Xml.XmlSerializer.dll

Ensamblado:

System.Xml.ReaderWriter.dll

Ensamblado:

System.Xml.dll

Ensamblado:

netstandard.dll

Obtiene o establece un valor que indica si XmlSerializer debe serializar un miembro establecido en null como una etiqueta vacía con el atributo xsi:nil establecido en 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 de propiedad

Boolean

true si XmlSerializer genera el atributo xsi:nil; en caso contrario, false.

Ejemplos

En el ejemplo siguiente se muestra un campo con el XmlElementAttribute aplicado y la IsNullable propiedad establecida en 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

Comentarios

La especificación de esquema XML para estructuras permite que un documento XML indique explícitamente que falta contenido de un elemento. Este elemento contiene el atributo xsi:nil establecido en true. Para obtener más información, vea especificación de World Wide Web Consortium, Esquema XML Parte 1: Estructuras.

Si la IsNullable propiedad se establece trueen , el xsi:nil atributo se genera para los miembros de clase que se han establecido en null. Por ejemplo, si establece un campo denominado en MyStringArray null, XmlSerializer genera el código XML siguiente.

<MyStringArray xsi:nil = "true" />  

Si la IsNullable propiedad es false, no se genera ningún elemento XML para los miembros de clase que se han establecido en null.

Nota

No se puede aplicar la IsNullable propiedad a un miembro escrito como un tipo de valor porque un tipo de valor no puede contener null. Además, no se puede establecer esta propiedad false en para los tipos de valor que aceptan valores NULL. Cuando estos tipos son null, se serializarán estableciendo xsi:nil en true.