XmlConvert クラス

.NET Framework クラス ライブラリ リファレンス

XmlConvert クラス

XML 名をエンコードおよびデコードし、共通言語ランタイム型と XML スキーマ定義言語 (XSD) 型との間で変換を実行するメソッドを提供します。データ型を変換する場合、返される値はロケールには依存しません。

名前空間: System.Xml
アセンブリ: System.Xml (system.xml.dll 内)
構文

Visual Basic (宣言)

Public Class XmlConvert

Visual Basic (使用法)

Dim instance As XmlConvert

C#

public class XmlConvert

C++

public ref class XmlConvert

J#

public class XmlConvert

JScript

public class XmlConvert

解説

要素および属性名または ID 値は、www.w3.org/TR/2000/REC-xml-20001006.html で公開されている、勧告『Extensible Markup Language (XML) 1.0 (Second Edition)』に従って、XML 文字の範囲に限定されています。名前に無効な文字が含まれている場合は、EncodeName メソッドおよび DecodeName メソッドを使用して、有効な XML 名に変換します。

Microsoft SQL Server、Microsoft Word などの多くの言語やアプリケーションでは、XML 名としては有効でない Unicode 文字を名前に使用できます。たとえば、"Order Detail" がデータベースの列ヘッダーであった場合、このデータベースでは、Order と Detail という語の間に空白を使用できます。ただし、XML では、Order と Detail の間の空白は無効な XML 文字であると見なされます。したがって、無効な文字である空白はエスケープされた 16 進エンコーディングに変換する必要があり、後からデコードできます。

EncodeName メソッドを XmlWriter クラスで使用すると、書き込まれる名前を確実に有効な XML 名にできます。"Order Detail" という名前を有効な XML 名に変換し、要素 <Order_0x0020_Detail>My order</Order_0x0020_Detail> を書き込む C# コードを次に示します。

 writer.WriteElementString(XmlConvert.EncodeName("Order Detail"),"My order");

また、XmlConvert は、文字列から .NET Framework データ型への変換、およびその逆の変換ができるようにするメソッドも提供します。データ変換時には、ロケールの設定は考慮されません。データ型は XML スキーマ (XSD) データ型に基づいています。

メモ
.NET Framework Version 2.0 では、XmlReader、XmlWriter、および XPathNavigator の各クラスに、型指定されたデータを処理できる新しいメソッドが用意されています。これらの新しいメソッドは、文字列から .NET Framework データ型への変換を処理します。

継承階層

System.Object
  System.Xml.XmlConvert

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
XmlConvert メンバ
System.Xml 名前空間