XmlElementAttribute.IsNullable Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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, setPublic Property IsNullable As BooleanValor de propiedad
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.