XmlAttributeAttribute.Form Właściwość

Definicja

Przestrzeń nazw:

System.Xml.Serialization

Zestaw:

System.Xml.ReaderWriter.dll

Źródło:

XmlAttributeAttribute.cs

Pobiera lub ustawia wartość wskazującą, czy nazwa atrybutu XML wygenerowana przez element jest kwalifikowana XmlSerializer .

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

Wartość właściwości

XmlSchemaForm

Jedna z XmlSchemaForm wartości. Wartość domyślna to XmlForm.None.

Przykłady

Poniższy przykład dotyczy XmlAttributeAttribute dwóch pól zawartych w klasie.

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

Uwagi

Właściwość Form określa, czy element XML jest kwalifikowany, czy niekwalifikowany. Właściwość jest zgodna Form ze specyfikacją Namespaces in XML1999 http://www.w3.org .

Namespace Jeśli właściwość jest ustawiona na dowolną wartość, spróbuj ustawić Form właściwość, aby zgłosić XmlSchemaForm.Unqualified wyjątek.

Ustawienie domyślne , XmlSchemaForm.Nonenakazuje XmlSerializer sprawdzenie schematu dokumentu XML w celu określenia, czy przestrzeń nazw jest kwalifikowana. Jeśli schemat nie określa wartości dla pojedynczego elementu lub atrybutu, wartości i używają elementFormDefault wartości i attributeFormDefault do określenia, XmlSerializer czy element lub atrybut jest kwalifikowany. Poniższy kod XML przedstawia schemat:

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

Gdy odczytuje XmlSerializer schemat, Form wartość parametru Name i Number ma XmlSchemaForm.Nonewartość , ale Name element jest kwalifikowany, podczas gdy Number element jest niekwalifikowany.