XmlAttributeAttribute.Form-Eigenschaft

Artikel
08/20/2007

Ruft einen Wert ab, der angibt, ob der von XmlSerializer generierte XML-Attributname gekennzeichnet ist, oder legt diesen fest.

Namespace: System.Xml.Serialization
Assembly: System.Xml (in system.xml.dll)

Syntax

'Declaration
Public Property Form As XmlSchemaForm
'Usage
Dim instance As XmlAttributeAttribute
Dim value As XmlSchemaForm

value = instance.Form

instance.Form = value

public XmlSchemaForm Form { get; set; }

public:
property XmlSchemaForm Form {
    XmlSchemaForm get ();
    void set (XmlSchemaForm value);
}

/** @property */
public XmlSchemaForm get_Form ()

/** @property */
public void set_Form (XmlSchemaForm value)

public function get Form () : XmlSchemaForm

public function set Form (value : XmlSchemaForm)

Eigenschaftenwert

Einer der XmlSchemaForm-Werte. Der Standardwert ist XmlForm.None.

Hinweise

Die Form-Eigenschaft bestimmt, ob ein XML-Element gekennzeichnet oder nicht gekennzeichnet ist. Die Form-Eigenschaft entspricht der http://www.w3.org-Spezifikation Namespaces in XML von 1999.

Wenn die Namespace-Eigenschaft auf einen beliebigen Wert festgelegt ist, löst der Versuch, die Form-Eigenschaft auf XmlSchemaForm.Unqualified festzulegen, eine Ausnahme aus.

Die Standardeinstellung XmlSchemaForm.None weist XmlSerializer an, das Schema für das XML-Dokument zu überprüfen und zu bestimmen, ob der Namespace gekennzeichnet ist. Wenn das Schema für ein einzelnes Element oder Attribut keinen Wert angibt, bestimmt XmlSerializer mit dem elementFormDefault-Wert und dem attributeFormDefault-Wert, ob ein Element bzw. Attribut gekennzeichnet ist. Im folgenden XML-Code wird ein Schema dargestellt:

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

Beim Lesen des Schemas durch XmlSerializer ist XmlSchemaForm.None der Form-Wert für Name und Number, jedoch ist das Name-Element gekennzeichnet, während das Number-Element nicht gekennzeichnet ist.

Beispiel

Im folgenden Beispiel wird XmlAttributeAttribute zwei in einer Klasse enthaltenen Elementen zugewiesen.

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

    <XmlAttribute(Form := XmlSchemaForm.Unqualified)> _
    Public ModelID As String
End Class

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

public ref class Vehicle
{
public:

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

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

public class Vehicle
{
    /** @attribute XmlAttribute(Form = XmlSchemaForm.Qualified)
     */
    public String maker;
    /** @attribute XmlAttribute(Form = XmlSchemaForm.Unqualified)
     */
    public String modelID;
} //Vehicle

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0

Siehe auch

Referenz

XmlAttributeAttribute-Klasse
XmlAttributeAttribute-Member
System.Xml.Serialization-Namespace

Freigeben über