XmlArrayItemAttribute.Form Propriété

Définition

Espace de noms:

System.Xml.Serialization

Assembly:

System.Xml.XmlSerializer.dll

Source:

XmlArrayItemAttribute.cs

Obtient ou définit une valeur qui indique si le nom de l'élément XML généré est qualifié.

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

Valeur de propriété

XmlSchemaForm

Une des valeurs de l'objet XmlSchemaForm. La valeur par défaut est XmlSchemaForm.None.

Exceptions

Exception

La propriété Form est définie avec la valeur XmlSchemaForm.Unqualified et une valeur Namespace est spécifiée.

Exemples

L’exemple suivant définit la Form propriété de la Vehicle classe sur XmlSchemaForm.Unqualifiedet la Form propriété de la Car classe sur XmlSchemaForm.Qualified.

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

Remarques

La Form propriété détermine si un nom d’élément XML est qualifié, en fonction de la spécification World Wide Web Consortium Namespaces in XML.

Si la Namespace propriété est définie sur une valeur quelconque, la tentative de définition de la Form propriété XmlSchemaForm.Unqualified sur lève une exception.

La valeur par défaut, XmlSchemaForm.None, indique à de XmlSerializer vérifier le schéma du document XML afin de déterminer si l’espace de noms est qualifié. Pour les éléments, vérifie XmlSerializer la valeur de l’attribut elementFormDefaultschema-element . Pour les attributs, il vérifie la valeur de l’attribut attributeFormDefaultschema-element . Par exemple, le schéma XML suivant indique que l’élément Name est qualifié, tandis que l’élément Number n’est pas qualifié.

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