XmlElementAttribute.Form プロパティ

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 つ。 既定値は、None です。

例

次の例では、 Form プロパティを XmlSchemaForm.Unqualified に設定します。

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

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

注釈

Form プロパティは、XML 要素が修飾されているか非修飾であるかを決定します。 Form プロパティは、World Wide Web Consortium 1999 仕様の XML の名前空間に準拠しています。

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

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

XmlSerializerがスキーマを読み取ると、NameとNumberの両方のForm値がXmlSchemaForm.Noneされますが、Name要素は修飾されますが、Number要素は修飾されます。