Sdílet prostřednictvím


XmlArrayItemAttribute.Form Vlastnost

Definice

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

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

Výjimky

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>  

Platí pro