XmlAttributeAttribute.Form 屬性
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得或設定值,指出 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 值。 預設值為 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
則不限定。