XmlElementAttribute.Form プロパティ

.NET Framework クラス ライブラリ リファレンス

XmlElementAttribute.Form プロパティ

要素が修飾されているかどうかを示す値を取得または設定します。

名前空間: System.Xml.Serialization
アセンブリ: System.Xml (system.xml.dll 内)
構文

Visual Basic (宣言)

Public Property Form As
 XmlSchemaForm

Visual Basic (使用法)

Dim instance As XmlElementAttribute
Dim value As XmlSchemaForm

value = instance.Form

instance.Form = value

C#

public XmlSchemaForm Form { get; set;
 }

C++

public:
property XmlSchemaForm Form {
    XmlSchemaForm get ();
    void set (XmlSchemaForm value);
}

J#

/** @property */
public XmlSchemaForm get_Form ()

/** @property */
public void set_Form (XmlSchemaForm value)

JScript

public function get Form
 () : XmlSchemaForm

public function set Form
 (value : XmlSchemaForm)

プロパティ値
XmlSchemaForm 値の 1 つ。既定値は Qualified です。

解説

Form プロパティは、XML 要素が限定されているかいないかを判断します。Form プロパティは、W3C (World Wide Web Consortium) (www.w3.org) の仕様『Namespaces in XML』 (1999 年) に準拠しています。

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 がスキーマを読み取ると、Name と Number の両方の Form 値は XmlSchemaForm.None になります。ただし、Name 要素は修飾されますが、Number 要素は修飾されません。

使用例

Form プロパティを XmlSchemaForm.Unqualified に設定する例を次に示します。

Visual Basic

Public Class MyClass1
    <XmlElement(Form := XmlSchemaForm.Unqualified)> _
    Public ClassName As String
End Class

C#

public class MyClass
{
   [XmlElement(Form = XmlSchemaForm.Unqualified)]
   public string ClassName;
}

C++

public ref class MyClass
{
public:

   [XmlElement(Form=XmlSchemaForm::Unqualified)]
   String^ ClassName;
};

J#

public class MyClass
{
    /** @attribute XmlElement(Form = XmlSchemaForm.Unqualified)
     */
    public String className;
} //MyClass

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
XmlElementAttribute クラス
XmlElementAttribute メンバ
System.Xml.Serialization 名前空間