XmlArrayItemAttribute.Form Propiedad

Definición

Espacio de nombres:

System.Xml.Serialization

Ensamblado:

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 valores de XmlSchemaForm. De manera predeterminada, es XmlSchemaForm.None.

Excepciones

Exception

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

Ejemplos

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

public ref class Vehicle
{
public:
   String^ id;
};

public ref class Car: public Vehicle
{
public:
   String^ Maker;
};

public ref class Transportation
{
public:

   // Specifies the Form property value.

   [XmlArray("Vehicles")]
   [XmlArrayItem(Vehicle::typeid,
   Form=XmlSchemaForm::Unqualified),
   XmlArrayItem(Car::typeid,
   Form=XmlSchemaForm::Qualified)]
   array<Vehicle^>^MyVehicles;
};

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, al intentar establecer la Form propiedad en XmlSchemaForm.Unqualified se produce 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 , XmlSerializer comprueba 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á calificado.

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