XmlArrayItemAttribute.Form Tulajdonság

Definíció

Névtér:

System.Xml.Serialization

Szerelvények:

netstandard.dll, System.Xml.XmlSerializer.dll

Forrás:

XmlArrayItemAttribute.cs

Lekéri vagy beállít egy értéket, amely jelzi, hogy a létrehozott XML-elem neve minősített-e.

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

Tulajdonság értéke

XmlSchemaForm

Az egyik XmlSchemaForm érték. Az alapértelmezett érték a XmlSchemaForm.None.

Kivételek

Exception

A Form tulajdonság be van állítva, XmlSchemaForm.Unqualified és meg van adva egy Namespace érték.

Példák

Az alábbi példa az Form osztály tulajdonságát Vehicle a következőre állítja, az XmlSchemaForm.Unqualified osztály tulajdonságát pedig a Form következőreCarXmlSchemaForm.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

Megjegyzések

A Form tulajdonság határozza meg, hogy az XML-elem neve minősített-e, a World Wide Web Consortium specifikációjának névterei alapján az XML-ben.

Ha a Namespace tulajdonság bármilyen értékre van állítva, a tulajdonságot Form megpróbálva kivételt okozni XmlSchemaForm.Unqualified .

Az alapértelmezett érték XmlSchemaForm.Nonearra utasítja a XmlSerializer sémát, hogy ellenőrizze az XML-dokumentum sémáját annak megállapításához, hogy a névtér minősített-e. Elemek esetén a XmlSerializer sémaelem attribútum elementFormDefaultértékét ellenőrzi. Attribútumok esetén ellenőrzi a sémaelem attribútum attributeFormDefaultértékét. Az alábbi XML-séma például azt jelzi, hogy az Name elem minősített, míg az Number elem nem minősített.

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