XmlAttributeAttribute.Form Eigenschaft

Definition

Ruft einen Wert ab, der angibt, ob der von XmlSerializer generierte XML-Attributname 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 XmlForm.None.

Beispiele

Im folgenden Beispiel werden die XmlAttributeAttribute in einer Klasse enthaltenen zwei Felder angewendet.

public ref class Vehicle
{
public:

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

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

   [XmlAttribute(Form = XmlSchemaForm.Unqualified)]
   public string ModelID;
}
Public Class Vehicle
    <XmlAttribute(Form := XmlSchemaForm.Qualified)> _
    Public Maker As String    

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

Hinweise

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

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

Die Standardeinstellung weist das XmlSerializer Schema für das XML-Dokument an, um zu ermitteln, XmlSchemaForm.Noneob der Namespace qualifiziert ist. Wenn das Schema keinen Wert für ein einzelnes Element oder Attribut angibt, verwendet dies XmlSerializer die und attributeFormDefault die elementFormDefault Werte, um zu bestimmen, 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 der Form Wert sowohl Name XmlSchemaForm.None``Number Name für die als auch für das Element qualifiziert, während das Number Element nicht qualifiziert ist.

Gilt für