XmlArrayItemAttribute.Form Eigenschaft

Definition

Namespace:

System.Xml.Serialization

Assembly:

System.Xml.XmlSerializer.dll

Source:

XmlArrayItemAttribute.cs

Ruft einen Wert ab, der angibt, ob der Name des generierten XML-Elements gekennzeichnet ist, oder legt diesen fest.

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

Eigenschaftswert

XmlSchemaForm

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

Ausnahmen

Exception

Die Form-Eigenschaft wird auf XmlSchemaForm.Unqualified festgelegt, und es wird ein Namespace-Wert angegeben.

Beispiele

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

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
{
   [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 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

Hinweise

Die Form -Eigenschaft bestimmt, ob ein XML-Elementname basierend auf den Spezifikationsnamespaces des World Wide Web Consortium in XML qualifiziert ist.

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

Der Standardwert weist den an, das XmlSerializer Schema für das XML-Dokument zu überprüfen, um zu bestimmen, XmlSchemaForm.Noneob der Namespace qualifiziert ist. Bei Elementen überprüft der XmlSerializer den Wert des Attributs schema-element elementFormDefault. Bei Attributen wird der Wert des Attributs schema-element attributeFormDefaultüberprüft. Das folgende XML-Schema gibt beispielsweise an, dass das Name Element qualifiziert ist, während das Number Element nicht qualifiziert ist.

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