XmlElementAttribute.Form Propriété

Définition

Espace de noms:

System.Xml.Serialization

Assembly:

System.Xml.ReaderWriter.dll

Source:

XmlElementAttribute.cs

Obtient ou définit une valeur qui indique si l'élément 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 None.

Exemples

L’exemple suivant définit la Form propriété sur XmlSchemaForm.Unqualified.

public ref class MyClass
{
public:

   [XmlElement(Form=XmlSchemaForm::Unqualified)]
   String^ ClassName;
};

public class MyClass
{
   [XmlElement(Form = XmlSchemaForm.Unqualified)]
   public string ClassName;
}

Public Class MyClass1
    <XmlElement(Form := XmlSchemaForm.Unqualified)> _
    Public ClassName As String
End Class

Remarques

La Form propriété détermine si un élément XML est qualifié ou non qualifié. La Form propriété est conforme à la spécification World Wide Web Consortium 1999, Espaces de noms en XML.

Si la Namespace propriété est définie sur une valeur quelconque, la tentative de définir la Form propriété sur XmlSchemaForm.Unqualified lève une exception. Le paramètre par défaut, XmlSchemaForm.None, indique à de XmlSerializer vérifier le schéma du document XML pour déterminer si l’espace de noms est qualifié. Si le schéma ne spécifie pas de valeur pour un élément ou un attribut individuel, le XmlSerializer utilise les elementFormDefault valeurs et attributeFormDefault pour déterminer si un élément ou un attribut est qualifié. Le code XML suivant montre un schéma :

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

Lorsque le XmlSerializer lit le schéma, la Form valeur de Name et Number est XmlSchemaForm.None, mais l’élément Name est qualifié, tandis que l’élément Number n’est pas qualifié.