XmlAttributeAttribute.Form Properti

Definisi

Ruang nama:

System.Xml.Serialization

Rakitan:

netstandard.dll, System.Xml.ReaderWriter.dll

Sumber:

XmlAttributeAttribute.cs

Mendapatkan atau menetapkan nilai yang menunjukkan apakah nama atribut XML yang dihasilkan oleh XmlSerializer memenuhi syarat.

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

Nilai Properti

XmlSchemaForm

Salah XmlSchemaForm satu nilai. Defaultnya adalah XmlForm.None.

Contoh

Contoh berikut menerapkan XmlAttributeAttribute ke dua bidang yang terkandung dalam kelas.

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

Keterangan

Properti Form menentukan apakah elemen XML memenuhi syarat atau tidak memenuhi syarat. Properti Form sesuai dengan spesifikasi Namespaces in XML1999 http://www.w3.org .

Namespace Jika properti diatur ke nilai apa pun, mencoba mengatur Form properti untuk XmlSchemaForm.Unqualified melemparkan pengecualian.

Pengaturan default, XmlSchemaForm.None, menginstruksikan XmlSerializer untuk memeriksa skema dokumen XML untuk menentukan apakah namespace layanan memenuhi syarat. Jika skema tidak menentukan nilai untuk elemen atau atribut individual, XmlSerializer menggunakan elementFormDefault nilai dan attributeFormDefault untuk menentukan apakah elemen atau atribut memenuhi syarat. Kode XML berikut menunjukkan skema:

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

XmlSerializer Ketika membaca skema, Form nilai untuk Name dan Number adalah XmlSchemaForm.None, tetapi Name elemen memenuhi syarat, sementara Number elemen tidak memenuhi syarat.