XmlArrayAttribute.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 como una etiqueta XML 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
true
si XmlSerializer genera el atributo xsi:nil
; en caso contrario, false
.
Ejemplos
El ejemplo siguiente contiene dos matrices: una con la IsNullable propiedad establecida true
en y otra con la IsNullable propiedad establecida false
en .
public ref class MyClass
{
public:
[XmlArray(IsNullable=true)]
array<String^>^IsNullableIsTrueArray;
[XmlArray(IsNullable=false)]
array<String^>^IsNullableIsFalseArray;
};
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
Comentarios
La especificación de esquema XML para estructuras permite que un documento XML indique explícitamente que falta el contenido de un elemento. Este elemento contiene el atributo xsi:nil
establecido en true
. Para obtener más información, vea la especificación de World Wide Web Consortium titulada Esquema XML Parte 1: Estructuras.
Si la IsNullable propiedad se establece true
en , el xsi:nil
atributo se genera para los miembros de clase que se han establecido en null
. Por ejemplo, si establece un campo denominado MyStringArray
en 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.
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
.