XmlArrayItemAttribute.Form Eigenschaft

Definition

Namespace:

System.Xml.Serialization

Assemblys:

netstandard.dll, System.Xml.XmlSerializer.dll

Quelle:

XmlArrayItemAttribute.cs

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Name des generierten XML-Elements qualifiziert ist.

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 lautet XmlSchemaForm.None.

Ausnahmen

Exception

Die Form Eigenschaft wird festgelegt XmlSchemaForm.Unqualified und ein Namespace Wert wird angegeben.

Beispiele

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.

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 qualifiziert ist, basierend auf den World Wide Web Consortium-Spezifikationsnamespaces in XML.

Wenn die Namespace Eigenschaft auf einen beliebigen Wert festgelegt ist, wird versucht, die Form Eigenschaft so festzulegen, dass XmlSchemaForm.Unqualified eine Ausnahme ausgelöst wird.

Der Standardwert weist das XmlSerializer Schema für das XML-Dokument an, um zu bestimmen, XmlSchemaForm.Noneob der Namespace qualifiziert ist. Bei Elementen überprüft der XmlSerializer Wert des Schemaelement-Attributs elementFormDefault. Bei Attributen wird der Wert des Schemaelement-Attributs 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>