XmlArrayItemAttribute.Form Propiedad

Definición

Espacio de nombres:

System.Xml.Serialization

Ensamblados:

netstandard.dll, System.Xml.XmlSerializer.dll

Source:

XmlArrayItemAttribute.cs

Obtiene o establece un valor que indica si el nombre del elemento XML generado está calificado.

public:
 property System::Xml::Schema::XmlSchemaForm Form { System::Xml::Schema::XmlSchemaForm get(); void set(System::Xml::Schema::XmlSchemaForm value); };

public System.Xml.Schema.XmlSchemaForm Form { get; set; }

member this.Form : System.Xml.Schema.XmlSchemaForm with get, set

Public Property Form As XmlSchemaForm

Valor de propiedad

XmlSchemaForm

Uno de los XmlSchemaForm valores. El valor predeterminado es XmlSchemaForm.None.

Excepciones

Exception

La Form propiedad se establece en XmlSchemaForm.Unqualified y se especifica un Namespace valor.

Ejemplos

En el ejemplo siguiente se establece la Form propiedad de la Vehicle clase XmlSchemaForm.Unqualifieden y la Form propiedad de la Car clase en XmlSchemaForm.Qualified.

public class Transportation
{
   [XmlArray("Vehicles")]
   // Specifies the Form property value.
   [XmlArrayItem(typeof(Vehicle),
   Form = XmlSchemaForm.Unqualified),
   XmlArrayItem(typeof(Car),
   Form = XmlSchemaForm.Qualified)]
   public Vehicle[] MyVehicles;
}

public class Vehicle
{
   public string id;
}

public class Car:Vehicle
{
   public string Maker;
}

Public Class Transportation
    ' Specify the Form property value.
    <XmlArray("Vehicles"), _
     XmlArrayItem(GetType(Vehicle), Form := XmlSchemaForm.Unqualified), _
     XmlArrayItem(GetType(Car), Form := XmlSchemaForm.Qualified)> _
    Public MyVehicles() As Vehicle
End Class

Public Class Vehicle
    Public id As String
End Class

Public Class Car
    Inherits Vehicle
    Public Maker As String
End Class

Comentarios

La Form propiedad determina si un nombre de elemento XML está calificado, en función de los espacios de nombres de especificación de World Wide Web Consortium en XML.

Si la Namespace propiedad se establece en cualquier valor, intentando establecer la Form propiedad para XmlSchemaForm.Unqualified producir una excepción.

El valor predeterminado, XmlSchemaForm.None, indica XmlSerializer a que compruebe el esquema del documento XML para determinar si el espacio de nombres está calificado. En el caso de los elementos , comprueba XmlSerializer el valor del atributo elementFormDefaultschema-element . En el caso de los atributos, comprueba el valor del atributo attributeFormDefaultschema-element . Por ejemplo, el siguiente esquema XML indica que el Name elemento está calificado, mientras que el Number elemento no está completo.

<schema elementFormDefault="qualified"
attributeFormDefault="unqualified">
   <element name="Name"/>
   <attribute name="Number"/>
</schema>