Condividi tramite


XmlArrayItemAttribute.Form Proprietà

Definizione

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

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à

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

Eccezioni

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

Esempio

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

Commenti

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

Se la Namespace proprietà è impostata su qualsiasi valore, il tentativo di impostare la Form proprietà per XmlSchemaForm.Unqualified generare un'eccezione.

Il valore predefinito, XmlSchemaForm.None, indica XmlSerializer a di controllare lo schema del documento XML per determinare se lo spazio dei nomi è qualificato. Per gli elementi, XmlSerializer controlla il valore dell'attributo elementFormDefaultschema-element . Per gli attributi, controlla il valore dell'attributo attributeFormDefaultschema-element . Ad esempio, il codice XML Schema seguente indica che l'elemento Name è qualificato, mentre l'elemento Number non è qualificato.

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

Si applica a