XmlArrayItemAttribute.Form Proprietà

Definizione

Spazio dei nomi:

System.Xml.Serialization

Assembly:

System.Xml.XmlSerializer.dll

Origine:

XmlArrayItemAttribute.cs

Ottiene o imposta un valore che indica se il nome dell'elemento XML generato è completo.

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

Valore della proprietà

XmlSchemaForm

Uno dei valori di XmlSchemaForm. Il valore predefinito è XmlSchemaForm.None.

Eccezioni

Exception

La proprietà Form è impostata su XmlSchemaForm.Unqualified e viene specificato un valore Namespace.

Esempio

Nell'esempio seguente viene impostata la proprietà per la FormVehicle classe su XmlSchemaForm.Unqualifiede la Form proprietà per la Car classe su 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

Commenti

La Form proprietà determina se un nome di elemento XML è qualificato, in base alle specifiche World Wide Web Consortium Namespaces in XML.

Se la proprietà è impostata su qualsiasi valore, tentando di impostare la NamespaceForm proprietà per XmlSchemaForm.Unqualified generare un'eccezione.

Il valore predefinito, , XmlSchemaForm.Noneindica all'utente di XmlSerializer controllare lo schema per il documento XML per determinare se lo spazio dei nomi è qualificato. Per gli elementi, controlla XmlSerializer il valore dell'attributo dell'elemento elementFormDefaultdello schema . Per gli attributi, controlla il valore dell'attributo dell'elemento attributeFormDefaultdello schema . Ad esempio, lo schema XML seguente indica che l'elemento è qualificato, mentre l'elemento NameNumber non è qualificato.

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