XmlArrayItemAttribute.Form プロパティ

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

XmlArrayItemAttribute.Form プロパティ

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

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

Visual Basic (宣言)

Public Property Form As
 XmlSchemaForm

Visual Basic (使用法)

Dim instance As XmlArrayItemAttribute
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 つ。既定値は XmlSchemaForm.None です。

例外

例外の種類	条件
Exception	Form プロパティが XmlSchemaForm.Unqualified に設定され、Namespace 値が指定されています。

解説

Form プロパティは、World Wide Web Consortium (www.w3.org) による仕様『Namespaces in XML』に基づいて、XML 要素名が限定されているかどうかを判断します。

Namespace プロパティに任意の値が設定されている場合は、Form プロパティを XmlSchemaForm.Unqualified に設定しようとすると例外がスローされます。

既定値 XmlSchemaForm.None では、XmlSerializer に対して、XML ドキュメントのスキーマを調べて名前空間が限定されているかどうかを判断するように指示します。要素については、XmlSerializer がスキーマ要素属性 elementFormDefault の値をチェックします。属性については、スキーマ要素属性 attributeFormDefault がチェックされます。たとえば、Name 要素が限定されており、Number 要素が限定されていないことを示す XML スキーマの例を次に示します。

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

使用例

Vehicle クラスの Form プロパティを XmlSchemaForm.Unqualified に設定し、Car クラスの Form プロパティを XmlSchemaForm.Qualified に設定する例を次に示します。

Visual Basic

Public Class Transportation
    ' Specify the Form property value.
    <XmlArray("Vehicles"), _
     XmlArrayItem(GetType(Vehicle), Form := XmlSchemaForm.Unqualified),
 _
     XmlArrayItem(GetType(Car), Form := XmlSchemaForm.Qualified)>
 _
    Public MyVehicles() As Vehicle
End Class

Public Class Vehicle
    Public id As String
End Class

Public Class Car
    Inherits Vehicle
    Public Maker As String
End Class

C#

public class Transportation
{  
   [XmlArray("Vehicles")]
   // Specifies the Form property value.
   [XmlArrayItem(typeof(Vehicle), 
   Form = XmlSchemaForm.Unqualified), 
   XmlArrayItem(typeof(Car), 
   Form = XmlSchemaForm.Qualified)]
   public Vehicle[] MyVehicles;
}

public class Vehicle
{
   public string id;
}

public class Car:Vehicle
{
   public string Maker;
}

C++

public ref class Vehicle
{
public:
   String^ id;
};

public ref class Car: public
 Vehicle
{
public:
   String^ Maker;
};

public ref class Transportation
{
public:

   // Specifies the Form property value.

   [XmlArray("Vehicles")]
   [XmlArrayItem(Vehicle::typeid,
   Form=XmlSchemaForm::Unqualified),
   XmlArrayItem(Car::typeid,
   Form=XmlSchemaForm::Qualified)]
   array<Vehicle^>^MyVehicles;
};

J#

public class Transportation
{
    /** @attribute XmlArray("Vehicles")
     */
    // Specifies the Form property value.
    /** @attribute XmlArrayItem(Vehicle.class, 
        Form = XmlSchemaForm.Unqualified)
        @attribute XmlArrayItem(Car.class,
        Form = XmlSchemaForm.Qualified)
     */
    public Vehicle myVehicles[];
} //Transportation

public class Vehicle
{
    public String id;
} //Vehicle

public class Car extends Vehicle
{
    public String maker;
} //Car

プラットフォーム

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

参照

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