XmlAttributeAttribute.Form 屬性

定義

命名空間:

System.Xml.Serialization

組件:

System.Xml.ReaderWriter.dll

Source:

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 ref class Vehicle
{
public:

   [XmlAttributeAttribute(Form=XmlSchemaForm::Qualified)]
   String^ Maker;

   [XmlAttributeAttribute(Form=XmlSchemaForm::Unqualified)]
   String^ ModelID;
};

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 使用 elementFormDefault 和 attributeFormDefault 值來判斷專案或屬性是否限定。 下列 XML 程式碼顯示架構：

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

XmlSerializer當 讀取架構時， Form 和 Number 的值 Name 都是 XmlSchemaForm.None ，但 Name 專案是限定的，而元素 Number 則不限定。