XmlArrayAttribute.Form プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
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, setPublic Property Form As XmlSchemaFormプロパティ値
XmlSchemaForm 値のいずれか 1 つ。 既定値は、XmlSchemaForm.None です。
例
次の例では、クラスのインスタンスをシリアル化します Enterprises 。 2 つの XML 要素には同じローカル名 (Company) がありますが、プレフィックスは異なります。 この例では、 Form 修飾名が XML インスタンスに確実に存在するようにプロパティを設定 XmlForm.Qualified します。
#using <System.Xml.dll>
#using <System.dll>
using namespace System;
using namespace System::IO;
using namespace System::Xml;
using namespace System::Xml::Schema;
using namespace System::Xml::Serialization;
public ref class Winery
{
public:
String^ Name;
};
public ref class VacationCompany
{
public:
String^ Name;
};
public ref class Enterprises
{
private:
array<Winery^>^wineries;
array<VacationCompany^>^companies;
public:
// Sets the Form property to qualified, and specifies the namespace.
[XmlArray(Form=XmlSchemaForm::Qualified,ElementName="Company",
Namespace="http://www.cohowinery.com")]
property array<Winery^>^ Wineries
{
array<Winery^>^ get()
{
return wineries;
}
void set( array<Winery^>^value )
{
wineries = value;
}
}
[XmlArray(Form=XmlSchemaForm::Qualified,ElementName="Company",
Namespace="http://www.treyresearch.com")]
property array<VacationCompany^>^ Companies
{
array<VacationCompany^>^ get()
{
return companies;
}
void set( array<VacationCompany^>^value )
{
companies = value;
}
}
};
int main()
{
String^ filename = "MyEnterprises.xml";
// Creates an instance of the XmlSerializer class.
XmlSerializer^ mySerializer = gcnew XmlSerializer( Enterprises::typeid );
// Writing file requires a TextWriter.
TextWriter^ writer = gcnew StreamWriter( filename );
// Creates an instance of the XmlSerializerNamespaces class.
XmlSerializerNamespaces^ ns = gcnew XmlSerializerNamespaces;
// Adds namespaces and prefixes for the XML document instance.
ns->Add( "winery", "http://www.cohowinery.com" );
ns->Add( "vacationCompany", "http://www.treyresearch.com" );
// Creates an instance of the class that will be serialized.
Enterprises^ myEnterprises = gcnew Enterprises;
// Creates objects and adds to the array.
Winery^ w1 = gcnew Winery;
w1->Name = "cohowinery";
array<Winery^>^myWinery = {w1};
myEnterprises->Wineries = myWinery;
VacationCompany^ com1 = gcnew VacationCompany;
com1->Name = "adventure-works";
array<VacationCompany^>^myCompany = {com1};
myEnterprises->Companies = myCompany;
// Serializes the class, and closes the TextWriter.
mySerializer->Serialize( writer, myEnterprises, ns );
writer->Close();
}
void ReadEnterprises( String^ filename )
{
XmlSerializer^ mySerializer = gcnew XmlSerializer( Enterprises::typeid );
FileStream^ fs = gcnew FileStream( filename,FileMode::Open );
Enterprises^ myEnterprises = dynamic_cast<Enterprises^>(mySerializer->Deserialize( fs ));
for ( int i = 0; i < myEnterprises->Wineries->Length; i++ )
{
Console::WriteLine( myEnterprises->Wineries[ i ]->Name );
}
for ( int i = 0; i < myEnterprises->Companies->Length; i++ )
{
Console::WriteLine( myEnterprises->Companies[ i ]->Name );
}
}
using System;
using System.IO;
using System.Xml;
using System.Xml.Schema;
using System.Xml.Serialization;
public class Enterprises
{
private Winery[] wineries;
private VacationCompany[] companies;
// Sets the Form property to qualified, and specifies the namespace.
[XmlArray(Form = XmlSchemaForm.Qualified, ElementName="Company",
Namespace="http://www.cohowinery.com")]
public Winery[] Wineries{
get{return wineries;}
set{wineries = value;}
}
[XmlArray(Form = XmlSchemaForm.Qualified, ElementName = "Company",
Namespace = "http://www.treyresearch.com")]
public VacationCompany [] Companies{
get{return companies;}
set{companies = value;}
}
}
public class Winery
{
public string Name;
}
public class VacationCompany{
public string Name;
}
public class Run
{
public static void Main()
{
Run test = new Run();
test.WriteEnterprises("MyEnterprises.xml");
}
public void WriteEnterprises(string filename)
{
// Creates an instance of the XmlSerializer class.
XmlSerializer mySerializer =
new XmlSerializer(typeof(Enterprises));
// Writing file requires a TextWriter.
TextWriter writer = new StreamWriter(filename);
// Creates an instance of the XmlSerializerNamespaces class.
XmlSerializerNamespaces ns = new XmlSerializerNamespaces();
// Adds namespaces and prefixes for the XML document instance.
ns.Add("winery", "http://www.cohowinery.com");
ns.Add("vacationCompany", "http://www.treyresearch.com");
// Creates an instance of the class that will be serialized.
Enterprises myEnterprises = new Enterprises();
// Creates objects and adds to the array.
Winery w1= new Winery();
w1.Name = "cohowinery";
Winery[]myWinery = {w1};
myEnterprises.Wineries = myWinery;
VacationCompany com1 = new VacationCompany();
com1.Name = "adventure-works";
VacationCompany[] myCompany = {com1};
myEnterprises.Companies = myCompany;
// Serializes the class, and closes the TextWriter.
mySerializer.Serialize(writer, myEnterprises, ns);
writer.Close();
}
public void ReadEnterprises(string filename)
{
XmlSerializer mySerializer =
new XmlSerializer(typeof(Enterprises));
FileStream fs = new FileStream(filename, FileMode.Open);
Enterprises myEnterprises = (Enterprises)
mySerializer.Deserialize(fs);
for(int i = 0; i < myEnterprises.Wineries.Length;i++)
{
Console.WriteLine(myEnterprises.Wineries[i].Name);
}
for(int i = 0; i < myEnterprises.Companies.Length;i++)
{
Console.WriteLine(myEnterprises.Companies[i].Name);
}
}
}
Imports System.IO
Imports System.Xml
Imports System.Xml.Schema
Imports System.Xml.Serialization
Public Class Enterprises
Private mywineries() As Winery
Private mycompanies() As VacationCompany
' Sets the Form property to qualified, and specifies the Namespace.
<XmlArray(Form := XmlSchemaForm.Qualified, _
ElementName := "Company", _
Namespace := "http://www.cohowinery.com")> _
Public Property Wineries() As Winery()
Get
Return mywineries
End Get
Set
mywineries = value
End Set
End Property
<XmlArray(Form := XmlSchemaForm.Qualified, _
ElementName := "Company", _
Namespace := "http://www.treyresearch.com")> _
Public Property Companies() As VacationCompany()
Get
Return mycompanies
End Get
Set
mycompanies = value
End Set
End Property
End Class
Public Class Winery
Public Name As String
End Class
Public Class VacationCompany
Public Name As String
End Class
Public Class Run
Public Shared Sub Main()
Dim test As New Run()
test.WriteEnterprises("MyEnterprises.xml")
End Sub
Public Sub WriteEnterprises(filename As String)
' Creates an instance of the XmlSerializer class.
Dim mySerializer As New XmlSerializer(GetType(Enterprises))
' Writing a file requires a TextWriter.
Dim writer As New StreamWriter(filename)
' Creates an instance of the XmlSerializerNamespaces class.
Dim ns As New XmlSerializerNamespaces()
' Adds namespaces and prefixes for the XML document instance.
ns.Add("winery", "http://www.cohowinery.com")
ns.Add("vacationCompany", "http://www.treyresearch.com")
' Creates an instance of the class that will be serialized.
Dim myEnterprises As New Enterprises()
' Creates objects and adds to the array.
Dim w1 As New Winery()
w1.Name = "cohowinery"
Dim myWinery(0) As Winery
myWinery(0) = w1
myEnterprises.Wineries = myWinery
Dim com1 As New VacationCompany()
com1.Name = "adventure-works"
Dim myCompany(0) As VacationCompany
myCompany(0) = com1
myEnterprises.Companies = myCompany
' Serializes the class, and closes the TextWriter.
mySerializer.Serialize(writer, myEnterprises, ns)
writer.Close()
End Sub
Public Sub ReadEnterprises(filename As String)
Dim mySerializer As New XmlSerializer(GetType(Enterprises))
Dim fs As New FileStream(filename, FileMode.Open)
Dim myEnterprises As Enterprises = CType(mySerializer.Deserialize(fs), Enterprises)
Dim i As Integer
For i = 0 To myEnterprises.Wineries.Length - 1
Console.WriteLine(myEnterprises.Wineries(i).Name)
Next i
For i = 0 To myEnterprises.Companies.Length - 1
Console.WriteLine(myEnterprises.Companies(i).Name)
Next i
End Sub
End Class
注釈
このプロパティは Form 、XML 要素名が修飾名か非修飾かを決定します。 このプロパティは Form 、XML の名前空間というタイトルの 1999 World Wide Web Consortium ドキュメント に準拠しています。
プロパティが任意の Namespace 値に設定されている場合、例外を Form スローするようにプロパティを XmlSchemaForm.Unqualified 設定しようとしています。
既定の設定では、 XmlSchemaForm.NoneXML ドキュメントの XmlSerializer スキーマをチェックして、名前空間が修飾されているかどうかを判断するように指示します。 スキーマで個々の要素または属性の値が指定されていない場合、XmlSerializer要素または属性が修飾されているかどうかを判断するために、その値とattributeFormDefault値が使用elementFormDefaultされます。 次の XML コードはスキーマを示しています。
<schema elementFormDefault="qualified"
attributeFormDefault="unqualified"... >
<element name="Name"/>
<attribute name="Number"/>
</schema>
スキーマをXmlSerializer読み取ると、Form要素が修飾されていない間に、Name要素と Number is XmlSchemaForm.Noneの両方NameのNumber値が修飾されます。