XmlArrayItemAttribute.Form Vlastnost

Definice

Obor názvů:

System.Xml.Serialization

Sestavení:

System.Xml.XmlSerializer.dll

Zdroj:

XmlArrayItemAttribute.cs

Získá nebo nastaví hodnotu, která označuje, zda název vygenerovaného xml elementu je kvalifikovaný.

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

Hodnota vlastnosti

XmlSchemaForm

Jedna z XmlSchemaForm hodnot. Výchozí formát je XmlSchemaForm.None.

Výjimky

Exception

Vlastnost Form je nastavena na XmlSchemaForm.Unqualified a je zadána Namespace hodnota.

Příklady

Následující příklad nastaví Form vlastnost třídy Vehicle na XmlSchemaForm.Unqualifieda Form vlastnost třídy Car na 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

Poznámky

Vlastnost Form určuje, zda je název elementu XML kvalifikovaný, na základě specifikace World Wide Web Consortium Obory názvů v XML.

Pokud je vlastnost nastavena Namespace na libovolnou hodnotu, pokus o Form nastavení vlastnosti na XmlSchemaForm.Unqualified vyvolá výjimku.

Výchozí hodnota , XmlSchemaForm.Nonedává pokyn XmlSerializer ke kontrole schématu pro dokument XML k určení, zda je obor názvů kvalifikovaný. U elementů XmlSerializer kontroluje hodnotu atributu elementFormDefaultschema-element . U atributů zkontroluje hodnotu atributu attributeFormDefaultschema-element . Například následující schéma XML označuje, že Name element je kvalifikovaný, zatímco Number element je nekvalifikovaný.

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