XmlArrayItemAttribute.Form Propriété

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é

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

Exceptions

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 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>