XmlSerializerNamespaces クラス
アセンブリ: System.Xml (system.xml.dll 内)


XmlSerializerNamespaces には、XML 名前空間のコレクションと、それぞれの名前空間に関連付けられたプリフィックスが格納されています。XmlSerializer は、この XmlSerializerNamespaces クラスのインスタンスを使用して、XML ドキュメントで修飾名を作成します。
XmlSerializerNamespaces に格納される XML 名前空間は、W3C (www.w3.org) による仕様『Namespaces in XML』に準拠する必要があります。
XML 名前空間を使用すると、XML ドキュメント内の XML 要素と属性の名前を修飾できます。修飾名は、プリフィックスとローカル名をコロンで区切った構成になっています。プリフィックスはプレースホルダとしてだけ機能し、名前空間を指定する URI に割り当てられます。汎用的に管理された URI 名前空間とローカル名を組み合わせることにより、生成される名前は、必ず汎用的に一意となります。
XML ドキュメントで修飾名を作成するには、次の手順を実行します。
-
XmlArrayAttribute
-
XmlArrayItemAttribute
-
XmlAttributeAttribute
-
XmlElementAttribute
-
XmlRootAttribute
-
XmlTypeAttribute
-
各属性の Namespace プロパティを、XmlSerializerNamespaces オブジェクトの名前空間値の 1 つに設定します。
-
XmlSerializerNamespaces を XmlSerializer の Serialize メソッドに渡します。
![]() |
---|
空の名前空間とプレフィックスのペアの作成はサポートされません。つまり、次のコードを使ってペアを作成することはできません。 |

XmlSerializerNamespaces オブジェクトを作成し、そのオブジェクトにプレフィックスと名前空間のペアを 2 つ追加する例を次に示します。この例では、次に XmlSerializerNamespaces を Serialize メソッドに渡し、このメソッドが Books オブジェクトを XML ドキュメントにシリアル化します。Serialize メソッドは、XmlSerializerNamespaces オブジェクトを使用して、各 XML 要素と属性を 2 つの名前空間のいずれかで修飾します。
Imports System Imports System.IO Imports System.Xml Imports System.Xml.Serialization Public Class Run Public Shared Sub Main() Dim test As New Run() test.SerializeObject("XmlNamespaces.xml") End Sub Public Sub SerializeObject(ByVal filename As String) Dim s As New XmlSerializer(GetType(Books)) ' Writing a file requires a TextWriter. Dim t As New StreamWriter(filename) ' Create an XmlSerializerNamespaces object and add two ' prefix-namespace pairs. Dim ns As New XmlSerializerNamespaces() ns.Add("books", "http://www.cpandl.com") ns.Add("money", "http://www.cohowinery.com") ' Create a Book instance. Dim b As New Book() b.TITLE = "A Book Title" Dim p As New Price() p.price = CDec(9.95) p.currency = "US Dollar" b.PRICE = p Dim bks As New Books() bks.Book = b s.Serialize(t, bks, ns) t.Close() End Sub End Class Public Class Books <XmlElement(Namespace := "http://www.cohowinery.com")> _ Public Book As Book End Class <XmlType(Namespace := "http://www.cpandl.com")> _ Public Class Book <XmlElement(Namespace := "http://www.cpandl.com")> _ Public TITLE As String <XmlElement(Namespace := "http://www.cohowinery.com")> _ Public PRICE As Price End Class Public Class Price <XmlAttribute(Namespace := "http://www.cpandl.com")> _ Public currency As String <XmlElement(Namespace := "http://www.cohowinery.com")> _ Public price As Decimal End Class
using System; using System.IO; using System.Xml; using System.Xml.Serialization; public class Run { public static void Main() { Run test = new Run(); test.SerializeObject("XmlNamespaces.xml"); } public void SerializeObject(string filename) { XmlSerializer s = new XmlSerializer(typeof(Books)); // Writing a file requires a TextWriter. TextWriter t = new StreamWriter(filename); /* Create an XmlSerializerNamespaces object and add two prefix-namespace pairs. */ XmlSerializerNamespaces ns = new XmlSerializerNamespaces(); ns.Add("books", "http://www.cpandl.com"); ns.Add("money", "http://www.cohowinery.com"); // Create a Book instance. Book b = new Book(); b.TITLE = "A Book Title"; Price p = new Price(); p.price = (decimal) 9.95; p.currency = "US Dollar"; b.PRICE = p; Books bks = new Books(); bks.Book = b; s.Serialize(t,bks,ns); t.Close(); } } public class Books { [XmlElement(Namespace = "http://www.cohowinery.com")] public Book Book; } [XmlType(Namespace ="http://www.cpandl.com")] public class Book { [XmlElement(Namespace = "http://www.cpandl.com")] public string TITLE; [XmlElement(Namespace ="http://www.cohowinery.com")] public Price PRICE; } public class Price { [XmlAttribute(Namespace = "http://www.cpandl.com")] public string currency; [XmlElement(Namespace = "http://www.cohowinery.com")] public decimal price; }
#using <System.Xml.dll> #using <System.dll> using namespace System; using namespace System::IO; using namespace System::Xml; using namespace System::Xml::Serialization; public ref class Price { public: [XmlAttributeAttribute(Namespace="http://www.cpandl.com")] String^ currency; [XmlElement(Namespace="http://www.cohowinery.com")] Decimal price; }; [XmlType(Namespace="http://www.cpandl.com")] public ref class Book { public: [XmlElement(Namespace="http://www.cpandl.com")] String^ TITLE; [XmlElement(Namespace="http://www.cohowinery.com")] Price^ PRICE; }; public ref class Books { public: [XmlElement(Namespace="http://www.cohowinery.com")] Book^ Book; }; public ref class Run { public: static void main() { Run^ test = gcnew Run; test->SerializeObject( "XmlNamespaces.xml" ); } void SerializeObject( String^ filename ) { XmlSerializer^ s = gcnew XmlSerializer( Books::typeid ); // Writing a file requires a TextWriter. TextWriter^ t = gcnew StreamWriter( filename ); /* Create an XmlSerializerNamespaces object and add two prefix-namespace pairs. */ XmlSerializerNamespaces^ ns = gcnew XmlSerializerNamespaces; ns->Add( "books", "http://www.cpandl.com" ); ns->Add( "money", "http://www.cohowinery.com" ); // Create a Book instance. Book^ b = gcnew Book; b->TITLE = "A Book Title"; Price^ p = gcnew Price; p->price = (Decimal)9.95; p->currency = "US Dollar"; b->PRICE = p; Books^ bks = gcnew Books; bks->Book = b; s->Serialize( t, bks, ns ); t->Close(); } }; int main() { Run::main(); }
import System.*; import System.IO.*; import System.Xml.*; import System.Xml.Serialization.*; public class Run { public static void main(String[] args) { Run test = new Run(); test.SerializeObject("XmlNamespaces.xml"); } //main public void SerializeObject(String filename) { XmlSerializer s = new XmlSerializer(Books.class.ToType()); // Writing a file requires a TextWriter. TextWriter t = new StreamWriter(filename); /* Create an XmlSerializerNamespaces object and add two prefix-namespace pairs. */ XmlSerializerNamespaces ns = new XmlSerializerNamespaces(); ns.Add("books", "http://www.cpandl.com"); ns.Add("money", "http://www.cohowinery.com"); // Create a Book instance. Book b = new Book(); b.title = "A Book Title"; Price p = new Price(); p.price = Convert.ToDecimal(9.95); p.currency = "US Dollar"; b.price = p; Books bks = new Books(); bks.book = b; s.Serialize(t, bks, ns); t.Close(); } //SerializeObject } //Run public class Books { /** @attribute XmlElement(Namespace = "http://www.cohowinery.com") */ public Book book; } //Books /** @attribute XmlType(Namespace = "http://www.cpandl.com") */ public class Book { /** @attribute XmlElement(Namespace = "http://www.cpandl.com") */ public String title; /** @attribute XmlElement(Namespace = "http://www.cohowinery.com") */ public Price price; } //Book public class Price { /** @attribute XmlAttribute(Namespace = "http://www.cpandl.com") */ public String currency; /** @attribute XmlElement(Namespace = "http://www.cohowinery.com") */ public System.Decimal price; } //Price

System.Xml.Serialization.XmlSerializerNamespaces


Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


XmlSerializerNamespaces コンストラクタ ()
アセンブリ: System.Xml (system.xml.dll 内)


XmlSerializerNamespaces クラスのインスタンスを作成し、そのオブジェクトにプリフィックスと名前空間のペアを追加する例を次に示します。
Private Sub CreateBook(filename As String) Try ' Create instance of XmlSerializerNamespaces and add the namespaces. Dim myNameSpaces As New XmlSerializerNamespaces() myNameSpaces.Add("BookName", "http://www.cpandl.com") ' Create instance of XmlSerializer and specify the type of object; ' to be serialized. Dim mySerializerObject As New XmlSerializer(GetType(MyBook)) Dim myWriter = New StreamWriter(filename) ' Create object to be serialized. Dim myXMLBook As New MyBook() myXMLBook.Author = "XMLAuthor" myXMLBook.BookName = "DIG THE XML" myXMLBook.Description = "This is a XML Book" Dim myBookPrice As New MyPriceClass() myBookPrice.Price = CDec(45.89) myBookPrice.Units = "$" myXMLBook.BookPrice = myBookPrice ' Serialize the object. mySerializerObject.Serialize(myWriter, myXMLBook, myNameSpaces) myWriter.Close() Catch e As Exception Console.WriteLine("Exception :" & e.Message & "Occured") End Try End Sub
private void CreateBook(string filename) { try { // Create instance of XmlSerializerNamespaces and add the namespaces. XmlSerializerNamespaces myNameSpaces = new XmlSerializerNamespaces(); myNameSpaces.Add("BookName", "http://www.cpandl.com"); // Create instance of XmlSerializer and specify the type of object // to be serialized. XmlSerializer mySerializerObject = new XmlSerializer(typeof(MyBook)); TextWriter myWriter = new StreamWriter(filename); // Create object to be serialized. MyBook myXMLBook = new MyBook(); myXMLBook.Author = "XMLAuthor"; myXMLBook.BookName = "DIG THE XML"; myXMLBook.Description = "This is a XML Book"; MyPriceClass myBookPrice = new MyPriceClass(); myBookPrice.Price = (decimal) 45.89; myBookPrice.Units = "$"; myXMLBook.BookPrice = myBookPrice; // Serialize the object. mySerializerObject.Serialize(myWriter, myXMLBook,myNameSpaces); myWriter.Close(); } catch(Exception e) { Console.WriteLine("Exception :" + e.Message + "Occured"); } }
public: void CreateBook( String^ filename ) { try { // Create instance of XmlSerializerNamespaces and add the namespaces. XmlSerializerNamespaces^ myNameSpaces = gcnew XmlSerializerNamespaces; myNameSpaces->Add( "BookName", "http://www.cpandl.com" ); // Create instance of XmlSerializer and specify the type of object // to be serialized. XmlSerializer^ mySerializerObject = gcnew XmlSerializer( MyBook::typeid ); TextWriter^ myWriter = gcnew StreamWriter( filename ); // Create object to be serialized. MyBook^ myXMLBook = gcnew MyBook; myXMLBook->Author = "XMLAuthor"; myXMLBook->BookName = "DIG THE XML"; myXMLBook->Description = "This is a XML Book"; MyPriceClass^ myBookPrice = gcnew MyPriceClass; myBookPrice->Price = (Decimal)45.89; myBookPrice->Units = "$"; myXMLBook->BookPrice = myBookPrice; // Serialize the object. mySerializerObject->Serialize( myWriter, myXMLBook, myNameSpaces ); myWriter->Close(); } catch ( Exception^ e ) { Console::WriteLine( "Exception: {0} occured", e->Message ); } }
private void CreateBook(String fileName) { try { // Create instance of XmlSerializerNamespaces and add the namespaces. XmlSerializerNamespaces myNameSpaces = new XmlSerializerNamespaces(); myNameSpaces.Add("bookName", "http://www.cpandl.com"); // Create instance of XmlSerializer and specify the type of object // to be serialized. XmlSerializer mySerializerObject = new XmlSerializer( MyBook.class.ToType()); TextWriter myWriter = new StreamWriter(fileName); // Create object to be serialized. MyBook myXMLBook = new MyBook(); myXMLBook.author = "XMLauthor"; myXMLBook.bookName = "DIG THE XML"; myXMLBook.description = "This is a XML Book"; MyPriceClass mybookPrice = new MyPriceClass(); mybookPrice.price = System.Convert.ToDecimal(45.89); mybookPrice.units = "$"; myXMLBook.bookPrice = mybookPrice; // Serialize the object. mySerializerObject.Serialize(myWriter, myXMLBook, myNameSpaces); myWriter.Close(); } catch (System.Exception e) { Console.WriteLine("Exception :" + e.get_Message() + "Occured"); } } //CreateBook

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


XmlSerializerNamespaces コンストラクタ (XmlSerializerNamespaces)
アセンブリ: System.Xml (system.xml.dll 内)


2 つの XmlQualifiedName オブジェクトを作成し、それらのオブジェクトから新しい XmlSerializerNamespaces インスタンスを作成する例を次に示します。
Private Function CreateFromQNames() As XmlSerializerNamespaces Dim q1 As New XmlQualifiedName("money", "http://www.cohowinery.com") Dim q2 As New XmlQualifiedName("books", "http://www.cpandl.com") Dim names() As XmlQualifiedName = {q1, q2} Return New XmlSerializerNamespaces(names) End Function
private XmlSerializerNamespaces CreateFromQNames() { XmlQualifiedName q1 = new XmlQualifiedName("money", "http://www.cohowinery.com"); XmlQualifiedName q2 = new XmlQualifiedName("books", "http://www.cpandl.com"); XmlQualifiedName[] names = {q1, q2}; return new XmlSerializerNamespaces(names); }
private: XmlSerializerNamespaces^ CreateFromQNames() { XmlQualifiedName^ q1 = gcnew XmlQualifiedName( "money","http://www.cohowinery.com" ); XmlQualifiedName^ q2 = gcnew XmlQualifiedName( "books","http://www.cpandl.com" ); array<XmlQualifiedName^>^ names = { q1, q2 }; return gcnew XmlSerializerNamespaces( names ); }
private XmlSerializerNamespaces CreateFromQNames() { XmlQualifiedName q1 = new XmlQualifiedName("money", "http://www.cohowinery.com"); XmlQualifiedName q2 = new XmlQualifiedName("books", "http://www.cpandl.com"); XmlQualifiedName names[] = { q1, q2 }; return new XmlSerializerNamespaces(names); } //CreateFromQNames

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


XmlSerializerNamespaces コンストラクタ (XmlQualifiedName[])
アセンブリ: System.Xml (system.xml.dll 内)


Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


XmlSerializerNamespaces コンストラクタ

名前 | 説明 |
---|---|
XmlSerializerNamespaces () | XmlSerializerNamespaces クラスの新しいインスタンスを初期化します。 .NET Compact Framework によってサポートされています。 |
XmlSerializerNamespaces (XmlQualifiedName[]) | XmlSerializerNamespaces クラスの新しいインスタンスを初期化します。 .NET Compact Framework によってサポートされています。 |
XmlSerializerNamespaces (XmlSerializerNamespaces) | プレフィックスと名前空間のペアのコレクションを保持する XmlSerializerNamespaces のインスタンスを指定して、XmlSerializerNamespaces クラスの新しいインスタンスを初期化します。 .NET Compact Framework によってサポートされています。 |

XmlSerializerNamespaces プロパティ
XmlSerializerNamespaces メソッド

名前 | 説明 | |
---|---|---|
![]() | Add | XmlSerializerNamespaces オブジェクトにプレフィックスと名前空間のペアを追加します。 |
![]() | Equals | オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。) |
![]() | GetHashCode | 特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。) |
![]() | GetType | 現在のインスタンスの Type を取得します。 ( Object から継承されます。) |
![]() | ReferenceEquals | 指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。) |
![]() | ToArray | XmlSerializerNamespaces オブジェクト内のプレフィックスと名前空間のペアの配列を取得します。 |
![]() | ToString | 現在の Object を表す String を返します。 ( Object から継承されます。) |

名前 | 説明 | |
---|---|---|
![]() | Finalize | Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。) |
![]() | MemberwiseClone | 現在の Object の簡易コピーを作成します。 ( Object から継承されます。) |

XmlSerializerNamespaces メンバ
XmlSerializer が XML ドキュメント インスタンスで修飾名を生成するために使用する XML 名前空間とプリフィックスが格納されています。
XmlSerializerNamespaces データ型で公開されるメンバを以下の表に示します。



名前 | 説明 | |
---|---|---|
![]() | Add | XmlSerializerNamespaces オブジェクトにプレフィックスと名前空間のペアを追加します。 |
![]() | Equals | オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。) |
![]() | GetHashCode | 特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。) |
![]() | GetType | 現在のインスタンスの Type を取得します。 (Object から継承されます。) |
![]() | ReferenceEquals | 指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。) |
![]() | ToArray | XmlSerializerNamespaces オブジェクト内のプレフィックスと名前空間のペアの配列を取得します。 |
![]() | ToString | 現在の Object を表す String を返します。 (Object から継承されます。) |

名前 | 説明 | |
---|---|---|
![]() | Finalize | Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。) |
![]() | MemberwiseClone | 現在の Object の簡易コピーを作成します。 (Object から継承されます。) |

Weblioに収録されているすべての辞書からXmlSerializerNamespacesを検索する場合は、下記のリンクをクリックしてください。

- XmlSerializerNamespacesのページへのリンク