XmlTypeMapping クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
1 つの型から別の型へのマッピングを格納します。
public ref class XmlTypeMapping : System::Xml::Serialization::XmlMapping
public class XmlTypeMapping : System.Xml.Serialization.XmlMapping
type XmlTypeMapping = class
inherit XmlMapping
Public Class XmlTypeMapping
Inherits XmlMapping
- 継承
例
次の例では、 という名前のフィールドVehicle
を含む という名前Transportation
のクラスのインスタンスをシリアル化します。
SoapElementAttributeがフィールドに適用されます。 フィールドをシリアル化すると、XML 要素名は "Vehicle" ではなく "Wheels" になります。 メソッドは SerializeOverride
を作成し、 の SoapAttributes プロパティを SoapElement に設定しますSoapElementAttributeSoapElementAttribute。
SoapAttributesは、 の作成XmlTypeMappingにSoapAttributeOverrides使用される に追加されます。
XmlSerializerは を使用してXmlTypeMapping構築され、クラスのTransportation
インスタンスが再びシリアル化されます。
SoapElementAttributeはシリアル化をオーバーライドするために使用されるため、生成された XML 要素名は "Wheels" ではなく "Truck" になります。
#using <System.Xml.dll>
#using <System.dll>
using namespace System;
using namespace System::IO;
using namespace System::Xml::Serialization;
using namespace System::Collections;
using namespace System::Xml;
using namespace System::Text;
public ref class Thing
{
public:
[SoapElement(IsNullable=true)]
String^ ThingName;
};
public ref class Transportation
{
public:
// The SoapElementAttribute specifies that the
// generated XML element name will be S"Wheels"
// instead of S"Vehicle".
[SoapElement("Wheels")]
String^ Vehicle;
[SoapElement(DataType="dateTime")]
DateTime CreationDate;
[SoapElement(IsNullable=true)]
Thing^ thing;
};
public ref class Test
{
public:
// Return an XmlSerializer used for overriding.
XmlSerializer^ CreateSoapOverrider()
{
// Create the SoapAttributes and SoapAttributeOverrides objects.
SoapAttributes^ soapAttrs = gcnew SoapAttributes;
SoapAttributeOverrides^ soapOverrides = gcnew SoapAttributeOverrides;
// Create an SoapElementAttribute to the Vehicles property.
SoapElementAttribute^ soapElement1 = gcnew SoapElementAttribute( "Truck" );
// Set the SoapElement to the Object*.
soapAttrs->SoapElement = soapElement1;
// Add the SoapAttributes to the SoapAttributeOverrides,specifying the member to.
soapOverrides->Add( Transportation::typeid, "Vehicle", soapAttrs );
// Create the XmlSerializer, and return it.
XmlTypeMapping^ myTypeMapping = (gcnew SoapReflectionImporter( soapOverrides ))->ImportTypeMapping( Transportation::typeid );
return gcnew XmlSerializer( myTypeMapping );
}
void SerializeOverride( String^ filename )
{
// Create an XmlSerializer instance.
XmlSerializer^ ser = CreateSoapOverrider();
// Create the Object* and serialize it.
Transportation^ myTransportation = gcnew Transportation;
myTransportation->Vehicle = "MyCar";
myTransportation->CreationDate = DateTime::Now;
myTransportation->thing = gcnew Thing;
XmlTextWriter^ writer = gcnew XmlTextWriter( filename,Encoding::UTF8 );
writer->Formatting = Formatting::Indented;
writer->WriteStartElement( "wrapper" );
ser->Serialize( writer, myTransportation );
writer->WriteEndElement();
writer->Close();
}
void SerializeObject( String^ filename )
{
// Create an XmlSerializer instance.
XmlSerializer^ ser = gcnew XmlSerializer( Transportation::typeid );
Transportation^ myTransportation = gcnew Transportation;
myTransportation->Vehicle = "MyCar";
myTransportation->CreationDate = DateTime::Now;
myTransportation->thing = gcnew Thing;
XmlTextWriter^ writer = gcnew XmlTextWriter( filename,Encoding::UTF8 );
writer->Formatting = Formatting::Indented;
writer->WriteStartElement( "wrapper" );
ser->Serialize( writer, myTransportation );
writer->WriteEndElement();
writer->Close();
}
};
int main()
{
Test^ t = gcnew Test;
t->SerializeObject( "SoapElementOriginal.xml" );
t->SerializeOverride( "SoapElementOverride.xml" );
Console::WriteLine( "Finished writing two XML files." );
}
using System;
using System.IO;
using System.Xml.Serialization;
using System.Collections;
using System.Xml;
using System.Text;
public class Transportation
{
// The SoapElementAttribute specifies that the
// generated XML element name will be "Wheels"
// instead of "Vehicle".
[SoapElement("Wheels")]
public string Vehicle;
[SoapElement(DataType = "dateTime")]
public DateTime CreationDate;
[SoapElement(IsNullable = true)]
public Thing thing;
}
public class Thing{
[SoapElement(IsNullable=true)] public string ThingName;
}
public class Test
{
public static void Main()
{
Test t = new Test();
t.SerializeObject("SoapElementOriginal.xml");
t.SerializeOverride("SoapElementOverride.xml");
Console.WriteLine("Finished writing two XML files.");
}
// Return an XmlSerializer used for overriding.
public XmlSerializer CreateSoapOverrider()
{
// Create the SoapAttributes and SoapAttributeOverrides objects.
SoapAttributes soapAttrs = new SoapAttributes();
SoapAttributeOverrides soapOverrides =
new SoapAttributeOverrides();
/* Create an SoapElementAttribute to override
the Vehicles property. */
SoapElementAttribute soapElement1 =
new SoapElementAttribute("Truck");
// Set the SoapElement to the object.
soapAttrs.SoapElement= soapElement1;
/* Add the SoapAttributes to the SoapAttributeOverrides,
specifying the member to override. */
soapOverrides.Add(typeof(Transportation), "Vehicle", soapAttrs);
// Create the XmlSerializer, and return it.
XmlTypeMapping myTypeMapping = (new SoapReflectionImporter
(soapOverrides)).ImportTypeMapping(typeof(Transportation));
return new XmlSerializer(myTypeMapping);
}
public void SerializeOverride(string filename)
{
// Create an XmlSerializer instance.
XmlSerializer ser = CreateSoapOverrider();
// Create the object and serialize it.
Transportation myTransportation =
new Transportation();
myTransportation.Vehicle = "MyCar";
myTransportation.CreationDate=DateTime.Now;
myTransportation.thing = new Thing();
XmlTextWriter writer =
new XmlTextWriter(filename, Encoding.UTF8);
writer.Formatting = Formatting.Indented;
writer.WriteStartElement("wrapper");
ser.Serialize(writer, myTransportation);
writer.WriteEndElement();
writer.Close();
}
public void SerializeObject(string filename){
// Create an XmlSerializer instance.
XmlSerializer ser = new XmlSerializer(typeof(Transportation));
Transportation myTransportation =
new Transportation();
myTransportation.Vehicle = "MyCar";
myTransportation.CreationDate = DateTime.Now;
myTransportation.thing = new Thing();
XmlTextWriter writer =
new XmlTextWriter(filename, Encoding.UTF8);
writer.Formatting = Formatting.Indented;
writer.WriteStartElement("wrapper");
ser.Serialize(writer, myTransportation);
writer.WriteEndElement();
writer.Close();
}
}
Imports System.IO
Imports System.Xml.Serialization
Imports System.Collections
Imports System.Xml
Imports System.Text
Public Class Transportation
' The SoapElementAttribute specifies that the
' generated XML element name will be "Wheels"
' instead of "Vehicle".
<SoapElement("Wheels")> Public Vehicle As String
<SoapElement(DataType:= "dateTime")> _
public CreationDate As DateTime
<SoapElement(IsNullable:= true)> _
public thing As Thing
End Class
Public Class Thing
<SoapElement(IsNullable:=true)> public ThingName As string
End Class
Public Class Test
Shared Sub Main()
Dim t As Test = New Test()
t.SerializeObject("SoapElementOriginalVb.xml")
t.SerializeOverride("SoapElementOverrideVb.xml")
Console.WriteLine("Finished writing two XML files.")
End Sub
' Return an XmlSerializer used for overriding.
Public Function CreateSoapOverrider() As XmlSerializer
' Create the SoapAttributes and SoapAttributeOverrides objects.
Dim soapAttrs As SoapAttributes = New SoapAttributes()
Dim soapOverrides As SoapAttributeOverrides = _
New SoapAttributeOverrides()
' Create a SoapElementAttribute to override
' the Vehicles property.
Dim soapElement1 As SoapElementAttribute = _
New SoapElementAttribute("Truck")
' Set the SoapElement to the object.
soapAttrs.SoapElement= soapElement1
' Add the SoapAttributes to the SoapAttributeOverrides,
' specifying the member to override.
soapOverrides.Add(GetType(Transportation), "Vehicle", soapAttrs)
' Create the XmlSerializer, and return it.
Dim myTypeMapping As XmlTypeMapping = (New _
SoapReflectionImporter (soapOverrides)).ImportTypeMapping _
(GetType(Transportation))
return New XmlSerializer(myTypeMapping)
End Function
Public Sub SerializeOverride(filename As String)
' Create an XmlSerializer instance.
Dim ser As XmlSerializer = CreateSoapOverrider()
' Create the object and serialize it.
Dim myTransportation As Transportation = _
New Transportation()
myTransportation.Vehicle = "MyCar"
myTransportation.CreationDate = DateTime.Now
myTransportation.thing= new Thing()
Dim writer As XmlTextWriter = _
New XmlTextWriter(filename, Encoding.UTF8)
writer.Formatting = Formatting.Indented
writer.WriteStartElement("wrapper")
ser.Serialize(writer, myTransportation)
writer.WriteEndElement()
writer.Close()
End Sub
Public Sub SerializeObject(filename As String)
' Create an XmlSerializer instance.
Dim ser As XmlSerializer = _
New XmlSerializer(GetType(Transportation))
Dim myTransportation As Transportation = _
New Transportation()
myTransportation.Vehicle = "MyCar"
myTransportation.CreationDate=DateTime.Now
myTransportation.thing= new Thing()
Dim writer As XmlTextWriter = _
new XmlTextWriter(filename, Encoding.UTF8)
writer.Formatting = Formatting.Indented
writer.WriteStartElement("wrapper")
ser.Serialize(writer, myTransportation)
writer.WriteEndElement()
writer.Close()
End Sub
End Class
注釈
クラスは XmlTypeMapping 、エンコードされた SOAP XML としてオブジェクトをシリアル化するために使用されます。 結果の XML は、 World Wide Web Consortium ドキュメントの「Simple Object Access Protocol (SOAP) 1.1」のセクション 5 に準拠しています。 クラスの XmlTypeMapping メソッドを ImportTypeMapping 呼び出して を SoapReflectionImporter 作成します。 クラスの XmlTypeMapping インスタンスを構築するには、 を XmlSerializer 使用します。 シリアル化を制御するには、「 エンコードされた SOAP シリアル化を制御する属性」に記載されている属性のいずれかを使用します。
プロパティ
ElementName |
この API は製品インフラストラクチャをサポートします。コードから直接使用するものではありません。 マップされる要素の名前を取得します。 |
ElementName |
この API は製品インフラストラクチャをサポートします。コードから直接使用するものではありません。 マップされる要素の名前を取得します。 (継承元 XmlMapping) |
Namespace |
マップされたオブジェクトの XML 名前空間を取得します。 |
Namespace |
この API は製品インフラストラクチャをサポートします。コードから直接使用するものではありません。 マップされる要素の名前空間を取得します。 (継承元 XmlMapping) |
TypeFullName |
名前空間および型を含む完全修飾型名を取得します。 |
TypeName |
マップされたオブジェクトの型名を取得します。 |
XsdElementName |
この API は製品インフラストラクチャをサポートします。コードから直接使用するものではありません。 マッピングの XSD 要素の名前を取得します。 (継承元 XmlMapping) |
XsdTypeName |
マップされたオブジェクトの XML 要素名を取得します。 |
XsdTypeNamespace |
マップされたオブジェクトの XML 名前空間を取得します。 |
メソッド
Equals(Object) |
指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object) |
GetHashCode() |
既定のハッシュ関数として機能します。 (継承元 Object) |
GetType() |
現在のインスタンスの Type を取得します。 (継承元 Object) |
MemberwiseClone() |
現在の Object の簡易コピーを作成します。 (継承元 Object) |
SetKey(String) |
この API は製品インフラストラクチャをサポートします。コードから直接使用するものではありません。 マッピングの検索に使用するキーを設定します。 (継承元 XmlMapping) |
ToString() |
現在のオブジェクトを表す文字列を返します。 (継承元 Object) |
適用対象
こちらもご覧ください
.NET