XmlArrayItemAttribute.Form プロパティ

定義

名前空間:

System.Xml.Serialization

アセンブリ:

System.Xml.XmlSerializer.dll

アセンブリ:

System.Xml.dll

アセンブリ:

netstandard.dll

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

例外

Exception

Form プロパティが XmlSchemaForm.Unqualified に設定され、Namespace 値が指定されています。

例

次の例では、クラスのFormプロパティを Vehicle 、クラスXmlSchemaForm.UnqualifiedのプロパティCar``XmlSchemaForm.Qualifiedを Form .

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;
};

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;
}

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

注釈

このプロパティは Form 、XML の World Wide Web Consortium 仕様名前空間に基づいて、XML 要素名を修飾するかどうかを決定 します。

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

既定値は、 XmlSchemaForm.NoneXML ドキュメントの XmlSerializer スキーマをチェックして、名前空間が修飾されているかどうかを判断するように指示します。 要素の場合、 XmlSerializer schema-element 属性 elementFormDefaultの値がチェックされます。 属性の場合は、schema-element 属性 attributeFormDefaultの値をチェックします。 たとえば、次の XML スキーマは、要素が Name 修飾されていることを示します Number が、要素は修飾されていないとします。

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