XmlArrayItemAttribute.Form-Eigenschaft

Ruft einen Wert ab, der angibt, ob der Name des generierten XML-Elements 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 XmlArrayItemAttribute
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 XmlSchemaForm.None.

Ausnahmen

Hinweise

Die Form-Eigenschaft bestimmt, ob ein XML-Elementname gemäß der World Wide Web Consortium-Spezifikation (www.w3.org) "Namespaces in XML" gekennzeichnet ist.

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

Der Standardwert XmlSchemaForm.None weist XmlSerializer an, das Schema des XML-Dokuments zu überprüfen und zu bestimmen, ob der Namespace gekennzeichnet ist. Bei Elementen überprüft XmlSerializer den Wert des Schema-Elementattributs elementFormDefault. Bei Attributen wird der Wert des Schema-Elementattributs attributeFormDefault überprüft. Das folgende XML-Schema gibt z. B. an, dass das Name-Element gekennzeichnet ist, während das Number-Element nicht gekennzeichnet ist.

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

Beispiel

Im folgenden Beispiel wird die Form-Eigenschaft für die Vehicle-Klasse auf XmlSchemaForm.Unqualified und die Form-Eigenschaft für die Car-Klasse auf XmlSchemaForm.Qualified festgelegt.

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

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 ref class Vehicle
{
public:
   String^ id;
};

public ref class Car: public Vehicle
{
public:
   String^ Maker;
};

public ref class Transportation
{
public:

   // Specifies the Form property value.

   [XmlArray("Vehicles")]
   [XmlArrayItem(Vehicle::typeid,
   Form=XmlSchemaForm::Unqualified),
   XmlArrayItem(Car::typeid,
   Form=XmlSchemaForm::Qualified)]
   array<Vehicle^>^MyVehicles;
};

public class Transportation
{
    /** @attribute XmlArray("Vehicles")
     */
    // Specifies the Form property value.
    /** @attribute XmlArrayItem(Vehicle.class, 
        Form = XmlSchemaForm.Unqualified)
        @attribute XmlArrayItem(Car.class,
        Form = XmlSchemaForm.Qualified)
     */
    public Vehicle myVehicles[];
} //Transportation

public class Vehicle
{
    public String id;
} //Vehicle

public class Car extends Vehicle
{
    public String maker;
} //Car

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

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