XmlArrayItemAttribute.Form Vlastnost

Definice

Získává nebo nastavuje hodnotu, která indikuje, jestli je název generovaného elementu XML kvalifikovaný.Gets or sets a value that indicates whether the name of the generated XML element is qualified.

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.One of the XmlSchemaForm values. Výchozí formát je XmlSchemaForm.None.The default is XmlSchemaForm.None.

Výjimky

FormVlastnost je nastavena na XmlSchemaForm.Unqualified Namespace hodnotu a je zadána hodnota.The Form property is set to XmlSchemaForm.Unqualified and a Namespace value is specified.

Příklady

Následující příklad nastaví Form vlastnost pro Vehicle třídu na XmlSchemaForm.Unqualified a Form vlastnost pro Car třídu na XmlSchemaForm.Qualified .The following example sets the Form property for the Vehicle class to XmlSchemaForm.Unqualified, and the Form property for the Car class to 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

FormVlastnost určuje, zda je název elementu XML kvalifikován, na základě oborů názvů specifikace konsorcium World Wide Web v jazyce XML.The Form property determines whether an XML element name is qualified, based on the World Wide Web Consortium specification Namespaces in XML.

Pokud Namespace je vlastnost nastavena na hodnotu any, pokus o nastavení Form vlastnosti tak, aby XmlSchemaForm.Unqualified vyvolal výjimku.If the Namespace property is set to any value, attempting to set the Form property to XmlSchemaForm.Unqualified throws an exception.

Výchozí hodnota, XmlSchemaForm.None , nastaví pokyn XmlSerializer ke kontrole schématu dokumentu XML, aby bylo možné zjistit, zda je obor názvů kvalifikován.The default value, XmlSchemaForm.None, instructs the XmlSerializer to check the schema for the XML document to determine whether the namespace is qualified. U elementů XmlSerializer kontroluje hodnota atributu elementu schématu elementFormDefault .For elements, the XmlSerializer checks the value of the schema-element attribute elementFormDefault. U atributů kontroluje hodnotu atributu Schema-element attributeFormDefault .For attributes, it checks the value of the schema-element attribute attributeFormDefault. Například následující schéma XML označuje, že Name element je kvalifikován, zatímco Number element je neúplný.For example, the following XML Schema indicates that the Name element is qualified, while the Number element is unqualified.

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

Platí pro