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 XmlSchemaForm valeurs. La valeur par défaut est XmlSchemaForm.None.

Exceptions

Exemples

L’exemple suivant définit la Form propriété de la Vehicle classe XmlSchemaForm.Unqualifiedsur , et 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 des espaces de noms de spécification World Wide Web Consortium dans XML.

Si la Namespace propriété est définie sur une valeur quelconque, toute tentative de définition de la Form propriété pour XmlSchemaForm.Unqualified lever une exception.

La valeur par défaut, XmlSchemaForm.Noneindique à l’utilisateur XmlSerializer de vérifier le schéma du document XML pour déterminer si l’espace de noms est qualifié. Pour les éléments, le contrôle XmlSerializer la valeur de l’attribut elementFormDefaultd’élément de schéma . Pour les attributs, il vérifie la valeur de l’attribut attributeFormDefaultd’élément de schéma . 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>