XmlAttributeAttribute.Form プロパティ

定義

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 値のいずれか 1 つ。 既定値は、XmlForm.None です。

次の例では、 クラス XmlAttributeAttribute に含まれる 2 つのフィールドに を適用します。

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値に設定されている場合、プロパティを にXmlSchemaForm.Unqualified設定Formしようとすると例外がスローされます。

既定の設定 である は、 XmlSchemaForm.Noneに対して、XML ドキュメントのスキーマを確認して、名前空間が修飾されているかどうかを判断するように指示 XmlSerializer します。 スキーマで個々の要素または属性の値が指定されていない場合、 XmlSerializer は と attributeFormDefault の値を使用elementFormDefaultして、要素または属性が修飾されているかどうかを判断します。 次の XML コードはスキーマを示しています。

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

XmlSerializerスキーマを読み取ると、 と NumberForm両方のName値は ですがXmlSchemaForm.NoneName 要素は修飾されますがNumber、 要素は修飾されていません。

適用対象