XmlAttributeAttribute.Form プロパティ

定義

名前空間:

System.Xml.Serialization

アセンブリ:

netstandard.dll, System.Xml.ReaderWriter.dll

ソース:

XmlAttributeAttribute.cs

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

XmlSchemaForm値の 1 つ。 既定値は、XmlForm.None です。

例

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

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 プロパティが任意の値に設定されている場合、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要素は修飾されます。