XmlElementAttribute.Form Eigenschaft

Definition

Namespace:

System.Xml.Serialization

Assemblys:

netstandard.dll, System.Xml.ReaderWriter.dll

Quelle:

XmlElementAttribute.cs

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Element 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 None.

Beispiele

Im folgenden Beispiel wird die Form Eigenschaft auf XmlSchemaForm.Unqualified.

public class MyClass
{
   [XmlElement(Form = XmlSchemaForm.Unqualified)]
   public string ClassName;
}

Public Class MyClass1
    <XmlElement(Form := XmlSchemaForm.Unqualified)> _
    Public ClassName As String
End Class

Hinweise

Die Form Eigenschaft bestimmt, ob ein XML-Element qualifiziert oder nicht qualifiziert ist. Die Form Eigenschaft entspricht der World Wide Web Consortium 1999-Spezifikation Namespaces 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. Die Standardeinstellung weist das XmlSerializer Schema für das XML-Dokument an, um zu bestimmen, XmlSchemaForm.Noneob der Namespace qualifiziert ist. Wenn das Schema keinen Wert für ein einzelnes Element oder Attribut angibt, bestimmt das Schema anhand der XmlSerializerelementFormDefault Werte attributeFormDefault , ob ein Element oder Attribut qualifiziert ist. Der folgende XML-Code zeigt ein Schema:

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

Wenn das XmlSerializer Schema gelesen wird, ist XmlSchemaForm.Noneder Form Wert sowohl für das Name und Number das Element als auch für das Name Element qualifiziert, während das Number Element nicht qualifiziert ist.