XmlAttributeAttribute.Form 屬性

定義

命名空間:

System.Xml.Serialization

組件:

netstandard.dll, System.Xml.ReaderWriter.dll

來源:

XmlAttributeAttribute.cs

取得或設定一個值，指示由 產生 XmlSerializer 的 XML 屬性名稱是否經過限定。

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

屬性值

XmlSchemaForm

這是其中一項 XmlSchemaForm 價值。 預設值為 XmlForm.None。

範例

以下範例將 應用 XmlAttributeAttribute 於類別中包含的兩個欄位。

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

備註

此 Form 屬性決定 XML 元素是否具備限定性或不合格性。 該 Form 性質符合1999 http://www.w3.org 年的規範 Namespaces in XML。

如果屬性 Namespace 設定為任意值，嘗試將屬性 Form 設為 會 XmlSchemaForm.Unqualified 拋出例外。

預設設定 XmlSchemaForm.None，指示 檢查 XmlSerializer XML 文件的結構，以判斷命名空間是否符合資格。 若結構未指定個別元素或屬性的值，則 XmlSerializer 使用 和 elementFormDefaultattributeFormDefault 值來判斷該元素或屬性是否被限定。 以下 XML 程式碼顯示了一個結構架構：

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

當 讀取 XmlSerializer schema 時，Form與 Number 的值皆Name為 XmlSchemaForm.None，但Name元素是限定的，而Number元素是非限定的。