XmlAttributeAttribute.Form Eigenschap

Definitie

Naamruimte:

System.Xml.Serialization

Assembly's:

netstandard.dll, System.Xml.ReaderWriter.dll

Bron:

XmlAttributeAttribute.cs

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de naam van het XML-kenmerk die door de XmlSerializer naam is gegenereerd, 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 XmlForm.None.

Voorbeelden

In het volgende voorbeeld worden de XmlAttributeAttribute twee velden in een klasse toegepast.

public class Vehicle
{
   [XmlAttribute(Form = XmlSchemaForm.Qualified)]
   public string Maker;

   [XmlAttribute(Form = XmlSchemaForm.Unqualified)]
   public string ModelID;
}

Public Class Vehicle
    <XmlAttribute(Form := XmlSchemaForm.Qualified)> _
    Public Maker As String    

    <XmlAttribute(Form := XmlSchemaForm.Unqualified)> _
    Public ModelID As String
End Class

Opmerkingen

De Form eigenschap bepaalt of een XML-element gekwalificeerd of niet-gekwalificeerd is. De Form eigenschap voldoet aan de specificatie http://www.w3.orgvan 1999Namespaces 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 standaardinstelling geeft XmlSchemaForm.Noneu de XmlSerializer opdracht om het schema voor het XML-document te controleren om te bepalen of de naamruimte is gekwalificeerd. Als in het schema geen waarde voor een afzonderlijk element of kenmerk wordt opgegeven, worden de XmlSerializerelementFormDefault en attributeFormDefault waarden gebruikt om te bepalen of een element of kenmerk is gekwalificeerd. De volgende XML-code toont een schema:

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

Wanneer het XmlSerializer schema wordt gelezen, is de Form waarde voor zowel de Name als NumberXmlSchemaForm.Nonede waarde, maar het Name element is gekwalificeerd, terwijl het Number element niet gekwalificeerd is.