XmlArrayItemAttribute.Form Eigenschap

Definitie

Naamruimte:

System.Xml.Serialization

Assembly's:

netstandard.dll, System.Xml.XmlSerializer.dll

Bron:

XmlArrayItemAttribute.cs

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de naam van het gegenereerde XML-element is gekwalificeerd.

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

Waarde van eigenschap

XmlSchemaForm

Een van de XmlSchemaForm waarden. De standaardwaarde is XmlSchemaForm.None.

Uitzonderingen

Exception

De Form eigenschap is ingesteld op XmlSchemaForm.Unqualified en er wordt een Namespace waarde opgegeven.

Voorbeelden

In het volgende voorbeeld wordt de Form eigenschap voor de Vehicle klasse ingesteld op XmlSchemaForm.Unqualified, en de Form eigenschap voor de Car klasse op 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

Opmerkingen

De Form eigenschap bepaalt of een XML-elementnaam is gekwalificeerd, op basis van de world wide web consortium-specificatienaamruimten in XML.

Als de Namespace eigenschap is ingesteld op een waarde, wordt geprobeerd de Form eigenschap in te stellen op XmlSchemaForm.Unqualified het genereren van een uitzondering.

Met de standaardwaarde geeft XmlSchemaForm.Noneu de XmlSerializer opdracht om het schema voor het XML-document te controleren om te bepalen of de naamruimte is gekwalificeerd. Voor elementen controleert de XmlSerializer waarde van het kenmerk elementFormDefaultschema-element. Voor kenmerken wordt de waarde van het kenmerk attributeFormDefaultschema-element gecontroleerd. Het volgende XML-schema geeft bijvoorbeeld aan dat het Name element is gekwalificeerd, terwijl het Number element niet gekwalificeerd is.

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