XmlAttributeAttribute.Form Propriété

Définition

Espace de noms:

System.Xml.Serialization

Assembly:

System.Xml.XmlSerializer.dll

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

Obtient ou définit une valeur qui indique si le nom d'attribut XML généré par XmlSerializer 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 XmlForm.None.

Exemples

L’exemple suivant applique les XmlAttributeAttribute deux champs contenus dans une classe.

public ref class Vehicle
{
public:

   [XmlAttributeAttribute(Form=XmlSchemaForm::Qualified)]
   String^ Maker;

   [XmlAttributeAttribute(Form=XmlSchemaForm::Unqualified)]
   String^ ModelID;
};

public class Vehicle
{
   [XmlAttribute(Form = XmlSchemaForm.Qualified)]
   public string Maker;

   [XmlAttribute(Form = XmlSchemaForm.Unqualified)]
   public string ModelID;
}

Public Class Vehicle
    <XmlAttribute(Form := XmlSchemaForm.Qualified)> _
    Public Maker As String    

    <XmlAttribute(Form := XmlSchemaForm.Unqualified)> _
    Public ModelID 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 Namespaces in XML1999 http://www.w3.org .

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.

Le paramètre par défaut, XmlSchemaForm.Noneindique à l’utilisateur 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, il XmlSerializer utilise les valeurs et attributeFormDefault les elementFormDefault utilise 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 schéma est lu, la Form valeur du Name schéma est Number XmlSchemaForm.None, mais l’élément Name est qualifié, tandis que l’élément Number n’est pas qualifié.