XmlElementAttribute.Form プロパティ

定義

要素が修飾されているかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether the element is qualified.

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 つ。One of the XmlSchemaForm values. 既定値は、None です。The default is None.

次の例ではForm 、プロパティXmlSchemaForm.Unqualifiedをに設定します。The following example sets the Form property to XmlSchemaForm.Unqualified.

public ref class MyClass
{
public:

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

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 要素が修飾されているかどうかを判断します。The Form property determines whether an XML element is qualified or unqualified. プロパティFormは、 XML の名前空間World Wide Web コンソーシアム1999仕様に準拠しています。The Form property conforms to the World Wide Web Consortium 1999 specification, Namespaces in XML.

プロパティがNamespace任意の値に設定されている場合、 FormプロパティをXmlSchemaForm.Unqualifiedに設定しようとすると、例外がスローされます。If the Namespace property is set to any value, attempting to set the Form property to XmlSchemaForm.Unqualified throws an exception. 既定の設定でXmlSchemaForm.Noneは、XML XmlSerializerドキュメントのスキーマを確認して、名前空間が修飾されているかどうかを確認するようにに指示します。The default setting, XmlSchemaForm.None, instructs the XmlSerializer to check the schema for the XML document to determine whether the namespace is qualified. スキーマで個々の要素または属性の値が指定されていXmlSerializerない場合elementFormDefaultattributeFormDefaultはおよびの値を使用して、要素または属性が修飾されているかどうかを判断します。If the schema does not specify a value for an individual element or attribute, the XmlSerializer uses the elementFormDefault and attributeFormDefault values to determine whether an element or attribute is qualified. 次の XML コードは、スキーマを示しています。The following XML code shows a schema:

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

XmlSerializerがスキーマNumber Name Number XmlSchemaForm.Noneを読み取った場合、 Nameとの両方の値はになりますが、要素は修飾されますが、要素は修飾されません。FormWhen the XmlSerializer reads the schema, the Form value for both the Name and Number is XmlSchemaForm.None, but the Name element is qualified, while the Number element is unqualified.

適用対象