XmlReader.Create メソッド

定義

名前空間:

System.Xml

アセンブリ:

netstandard.dll, System.Xml.ReaderWriter.dll

新しい XmlReader インスタンスを作成します。

オーバーロード

名前	説明
Create(String, XmlReaderSettings, XmlParserContext)	指定した URI、設定、および解析のコンテキスト情報を使用して、新しい XmlReader インスタンスを作成します。
Create(TextReader, XmlReaderSettings, XmlParserContext)	指定したテキスト リーダー、設定、および解析用のコンテキスト情報を使用して、新しい XmlReader インスタンスを作成します。
Create(Stream, XmlReaderSettings, XmlParserContext)	指定したストリーム、設定、および解析用のコンテキスト情報を使用して、新しい XmlReader インスタンスを作成します。
Create(Stream, XmlReaderSettings, String)	指定したストリーム、ベース URI、および設定を使用して、新しい XmlReader インスタンスを作成します。
Create(XmlReader, XmlReaderSettings)	指定した XML リーダーと設定を使用して、新しい XmlReader インスタンスを作成します。
Create(TextReader, XmlReaderSettings, String)	指定したテキスト リーダー、設定、およびベース URI を使用して、新しい XmlReader インスタンスを作成します。
Create(TextReader, XmlReaderSettings)	指定したテキスト リーダーと設定を使用して、新しい XmlReader インスタンスを作成します。
Create(Stream, XmlReaderSettings)	指定したストリームと設定を使用して、新しい XmlReader インスタンスを作成します。
Create(String)	指定した URI で新しい XmlReader インスタンスを作成します。
Create(TextReader)	指定したテキスト リーダーを使用して、新しい XmlReader インスタンスを作成します。
Create(Stream)	既定の設定で指定したストリームを使用して、新しい XmlReader インスタンスを作成します。
Create(String, XmlReaderSettings)	指定した URI と設定を使用して、新しい XmlReader インスタンスを作成します。

注釈

この API の詳細については、「 XmlReader.Close の補足 API 解説」を参照してください。

Create(String, XmlReaderSettings, XmlParserContext)

ソース:

XmlReader.cs

指定した URI、設定、および解析のコンテキスト情報を使用して、新しい XmlReader インスタンスを作成します。

public:
 static System::Xml::XmlReader ^ Create(System::String ^ inputUri, System::Xml::XmlReaderSettings ^ settings, System::Xml::XmlParserContext ^ inputContext);

public static System.Xml.XmlReader Create(string inputUri, System.Xml.XmlReaderSettings? settings, System.Xml.XmlParserContext? inputContext);

static member Create : string * System.Xml.XmlReaderSettings * System.Xml.XmlParserContext -> System.Xml.XmlReader

Public Shared Function Create (inputUri As String, settings As XmlReaderSettings, inputContext As XmlParserContext) As XmlReader

パラメーター

inputUri

String

XML データを含むファイルの URI。 XmlReaderSettings オブジェクトのXmlResolver オブジェクトは、パスを正規のデータ表現に変換するために使用されます。 XmlResolverがnullされている場合は、新しいXmlUrlResolver オブジェクトが使用されます。

settings

XmlReaderSettings

新しい XmlReader インスタンスの設定。 この値は、null の場合もあります。

inputContext

XmlParserContext

XML フラグメントを解析するために必要なコンテキスト情報。 コンテキスト情報には、使用する XmlNameTable 、エンコード、名前空間スコープ、現在の xml:lang 、 xml:space スコープ、ベース URI、ドキュメント型の定義を含めることができます。

この値は、null の場合もあります。

戻り値

XmlReader

ストリーム内の XML データを読み取るために使用されるオブジェクト。

例外

ArgumentNullException

inputUri 値は nullです。

SecurityException

XmlReaderには、XML データの場所にアクセスするための十分なアクセス許可がありません。

ArgumentException

NameTableプロパティとNameTable プロパティの両方に値が含まれています。 (これらの NameTable プロパティの 1 つだけを設定して使用できます)。

FileNotFoundException

URI で指定されたファイルが見つかりません。

UriFormatException

URI 形式が正しくありません。

注釈

既定では、資格情報のない XmlUrlResolver は、ドキュメント型定義 (DTD)、エンティティ、スキーマなどの外部リソースにアクセスするために使用されます。

Important

.NET Framework 4.5.2 以降では、既定の XmlUrlResolver は提供されません。 ソリューションが .NET Framework 4.5.2 以降のバージョンを対象とする場合は、XmlReaderSettings.XmlResolver プロパティを使用してXmlResolverを指定します。

つまり、 XmlReader は認証を必要としない任意の場所にアクセスできます。 外部リソースが認証を必要とするネットワーク リソース上にある場合は、 XmlReaderSettings.XmlResolver プロパティを使用して、必要な資格情報で XmlResolver を指定します。

Important

XmlResolver プロパティをXmlSecureResolver オブジェクトに設定することで、XmlReaderがアクセスできるリソースを制限できます。

作成された XmlReader オブジェクトは、エンティティ参照を拡張し、改行文字の XML 正規化を実行します。

Create(TextReader, XmlReaderSettings, XmlParserContext)

ソース:

XmlReader.cs

指定したテキスト リーダー、設定、および解析用のコンテキスト情報を使用して、新しい XmlReader インスタンスを作成します。

public:
 static System::Xml::XmlReader ^ Create(System::IO::TextReader ^ input, System::Xml::XmlReaderSettings ^ settings, System::Xml::XmlParserContext ^ inputContext);

public static System.Xml.XmlReader Create(System.IO.TextReader input, System.Xml.XmlReaderSettings? settings, System.Xml.XmlParserContext? inputContext);

static member Create : System.IO.TextReader * System.Xml.XmlReaderSettings * System.Xml.XmlParserContext -> System.Xml.XmlReader

Public Shared Function Create (input As TextReader, settings As XmlReaderSettings, inputContext As XmlParserContext) As XmlReader

パラメーター

input

TextReader

XML データの読み取り元のテキスト リーダー。 テキスト リーダーは Unicode 文字のストリームを返します。そのため、XML 宣言で指定されたエンコードは、データ ストリームをデコードするために XML リーダーによって使用されません。

settings

XmlReaderSettings

新しい XmlReader インスタンスの設定。 この値は、null の場合もあります。

inputContext

XmlParserContext

XML フラグメントを解析するために必要なコンテキスト情報。 コンテキスト情報には、使用する XmlNameTable 、エンコード、名前空間スコープ、現在の xml:lang 、 xml:space スコープ、ベース URI、ドキュメント型の定義を含めることができます。

この値は、null の場合もあります。

戻り値

XmlReader

ストリーム内の XML データを読み取るために使用されるオブジェクト。

例外

ArgumentNullException

input 値は nullです。

ArgumentException

NameTableプロパティとNameTable プロパティの両方に値が含まれています。 (設定および使用できるのは、これらの NameTable プロパティのいずれか 1 つだけです)。

例

次の例では、XML フラグメントを読み取る XmlReader オブジェクトを作成します。

string xmlFrag ="<item rk:ID='abc-23'>hammer</item> " +
                        "<item rk:ID='r2-435'>paint</item>" +
                        "<item rk:ID='abc-39'>saw</item>";

// Create the XmlNamespaceManager.
NameTable nt = new NameTable();
XmlNamespaceManager nsmgr = new XmlNamespaceManager(nt);
nsmgr.AddNamespace("rk", "urn:store-items");

// Create the XmlParserContext.
XmlParserContext context = new XmlParserContext(null, nsmgr, null, XmlSpace.None);

// Create the reader.
XmlReaderSettings settings = new XmlReaderSettings();
settings.ConformanceLevel = ConformanceLevel.Fragment;
XmlReader reader = XmlReader.Create(new StringReader(xmlFrag), settings, context);

Dim xmlFrag As String = "<item rk:ID='abc-23'>hammer</item> " & _
                                     "<item rk:ID='r2-435'>paint</item>" & _
                                     "<item rk:ID='abc-39'>saw</item>"

' Create the XmlNamespaceManager.
Dim nt As New NameTable()
Dim nsmgr As New XmlNamespaceManager(nt)
nsmgr.AddNamespace("rk", "urn:store-items")

' Create the XmlParserContext.
Dim context As New XmlParserContext(Nothing, nsmgr, Nothing, XmlSpace.None)

' Create the reader. 
Dim settings As New XmlReaderSettings()
settings.ConformanceLevel = ConformanceLevel.Fragment
Dim reader As XmlReader = XmlReader.Create(New StringReader(xmlFrag), settings, context)

注釈

既定では、資格情報のない XmlUrlResolver は、ドキュメント型定義 (DTD)、エンティティ、スキーマなどの外部リソースにアクセスするために使用されます。

Important

.NET Framework 4.5.2 以降では、既定の XmlUrlResolver は提供されません。 ソリューションが .NET Framework 4.5.2 以降のバージョンを対象とする場合は、XmlReaderSettings.XmlResolver プロパティを使用してXmlResolverを指定します。

外部リソースが認証を必要とするネットワーク リソース上にある場合は、 XmlReaderSettings.XmlResolver プロパティを使用して、必要な資格情報で XmlResolver を指定します。

Important

次のいずれかの方法を使用して、 XmlReader がアクセスできるリソースを制御できます。

• XmlReader プロパティをXmlResolver オブジェクトに設定して、XmlSecureResolverがアクセスできるリソースを制限します。

-又は-

• XmlReader プロパティを XmlResolver に設定して、nullが外部リソースを開くことを許可しないでください。

作成された XmlReader オブジェクトは、エンティティ参照を拡張し、改行文字の XML 正規化を実行します。

Create(Stream, XmlReaderSettings, XmlParserContext)

ソース:

XmlReader.cs

指定したストリーム、設定、および解析用のコンテキスト情報を使用して、新しい XmlReader インスタンスを作成します。

public:
 static System::Xml::XmlReader ^ Create(System::IO::Stream ^ input, System::Xml::XmlReaderSettings ^ settings, System::Xml::XmlParserContext ^ inputContext);

public static System.Xml.XmlReader Create(System.IO.Stream input, System.Xml.XmlReaderSettings? settings, System.Xml.XmlParserContext? inputContext);

static member Create : System.IO.Stream * System.Xml.XmlReaderSettings * System.Xml.XmlParserContext -> System.Xml.XmlReader

Public Shared Function Create (input As Stream, settings As XmlReaderSettings, inputContext As XmlParserContext) As XmlReader

パラメーター

input

Stream

XML データを含むストリーム。

XmlReaderは、ストリームの最初のバイトをスキャンして、バイト オーダー マークまたはその他のエンコード記号を探します。 エンコードが決定されると、エンコードはストリームの読み取りを続行するために使用され、処理は入力を (Unicode) 文字のストリームとして解析し続けます。

settings

XmlReaderSettings

新しい XmlReader インスタンスの設定。 この値は、null の場合もあります。

inputContext

XmlParserContext

XML フラグメントを解析するために必要なコンテキスト情報。 コンテキスト情報には、使用する XmlNameTable 、エンコード、名前空間スコープ、現在の xml:lang 、 xml:space スコープ、ベース URI、ドキュメント型の定義を含めることができます。

この値は、null の場合もあります。

戻り値

XmlReader

ストリーム内の XML データを読み取るために使用されるオブジェクト。

例外

ArgumentNullException

input 値は nullです。

注釈

既定では、資格情報のない XmlUrlResolver は、ドキュメント型定義 (DTD)、エンティティ、スキーマなどの外部リソースにアクセスするために使用されます。

Important

.NET Framework 4.5.2 以降では、既定の XmlUrlResolver は提供されません。 ソリューションが .NET Framework 4.5.2 以降のバージョンを対象とする場合は、XmlReaderSettings.XmlResolver プロパティを使用してXmlResolverを指定します。

外部リソースが認証を必要とするネットワーク リソース上にある場合は、 XmlReaderSettings.XmlResolver プロパティを使用して、必要な資格情報で XmlResolver を指定します。

Important

次のいずれかの方法を使用して、 XmlReader がアクセスできるリソースを制御できます。

• XmlReader プロパティをXmlResolver オブジェクトに設定して、XmlSecureResolverがアクセスできるリソースを制限します。

-又は-

• XmlReader プロパティを XmlResolver に設定して、nullが外部リソースを開くことを許可しないでください。

作成された XmlReader オブジェクトは、エンティティ参照を拡張し、改行文字の XML 正規化を実行します。

Create(Stream, XmlReaderSettings, String)

ソース:

XmlReader.cs

指定したストリーム、ベース URI、および設定を使用して、新しい XmlReader インスタンスを作成します。

public:
 static System::Xml::XmlReader ^ Create(System::IO::Stream ^ input, System::Xml::XmlReaderSettings ^ settings, System::String ^ baseUri);

public static System.Xml.XmlReader Create(System.IO.Stream input, System.Xml.XmlReaderSettings? settings, string? baseUri);

static member Create : System.IO.Stream * System.Xml.XmlReaderSettings * string -> System.Xml.XmlReader

Public Shared Function Create (input As Stream, settings As XmlReaderSettings, baseUri As String) As XmlReader

パラメーター

input

Stream

XML データを含むストリーム。

XmlReaderは、ストリームの最初のバイトをスキャンして、バイト オーダー マークまたはその他のエンコード記号を探します。 エンコードが決定されると、エンコードはストリームの読み取りを続行するために使用され、処理は入力を (Unicode) 文字のストリームとして解析し続けます。

settings

XmlReaderSettings

新しい XmlReader インスタンスの設定。 この値は、null の場合もあります。

baseUri

String

読み取るエンティティまたはドキュメントのベース URI。 この値は、null の場合もあります。

セキュリティに関する注意 ベース URI は、XML ドキュメントの相対 URI を解決するために使用されます。 信頼されていないソースのベース URI は使用しないでください。

戻り値

XmlReader

ストリーム内の XML データを読み取るために使用されるオブジェクト。

例外

ArgumentNullException

input 値は nullです。

注釈

既定では、資格情報のない XmlUrlResolver は、ドキュメント型定義 (DTD)、エンティティ、スキーマなどの外部リソースにアクセスするために使用されます。

Important

.NET Framework 4.5.2 以降では、既定の XmlUrlResolver は提供されません。 ソリューションが .NET Framework 4.5.2 以降のバージョンを対象とする場合は、XmlReaderSettings.XmlResolver プロパティを使用してXmlResolverを指定します。

外部リソースが認証を必要とするネットワーク リソース上にある場合は、 XmlReaderSettings.XmlResolver プロパティを使用して、必要な資格情報で XmlResolver を指定します。

Important

次のいずれかの方法を使用して、 XmlReader がアクセスできるリソースを制御できます。

• XmlReader プロパティをXmlResolver オブジェクトに設定して、XmlSecureResolverがアクセスできるリソースを制限します。

-又は-

• XmlReader プロパティを XmlResolver に設定して、nullが外部リソースを開くことを許可しないでください。

作成された XmlReader オブジェクトは、エンティティ参照を拡張し、改行文字の XML 正規化を実行します。

Create(XmlReader, XmlReaderSettings)

ソース:

XmlReader.cs

指定した XML リーダーと設定を使用して、新しい XmlReader インスタンスを作成します。

public:
 static System::Xml::XmlReader ^ Create(System::Xml::XmlReader ^ reader, System::Xml::XmlReaderSettings ^ settings);

public static System.Xml.XmlReader Create(System.Xml.XmlReader reader, System.Xml.XmlReaderSettings? settings);

static member Create : System.Xml.XmlReader * System.Xml.XmlReaderSettings -> System.Xml.XmlReader

Public Shared Function Create (reader As XmlReader, settings As XmlReaderSettings) As XmlReader

パラメーター

reader

XmlReader

基になる XML リーダーとして使用するオブジェクト。

settings

XmlReaderSettings

新しい XmlReader インスタンスの設定。

XmlReaderSettings オブジェクトの準拠レベルは、基になるリーダーの準拠レベルと一致するか、Autoに設定する必要があります。

戻り値

XmlReader

指定した XmlReader オブジェクトの周囲にラップされるオブジェクト。

例外

ArgumentNullException

reader 値は nullです。

InvalidOperationException

XmlReaderSettings オブジェクトが、基になるリーダーの準拠レベルと一致しない準拠レベルを指定する場合。

-又は-

基になる XmlReader は、 Error または Closed 状態です。

例

次の例では、XmlNodeReader オブジェクトの周囲にラップされた検証XmlReaderオブジェクトを作成します。

// Create the XmlNodeReader object.
XmlDocument doc = new XmlDocument();
doc.Load("books.xml");
XmlNodeReader nodeReader = new XmlNodeReader(doc);

// Set the validation settings.
XmlReaderSettings settings = new XmlReaderSettings();
settings.ValidationType = ValidationType.Schema;
settings.Schemas.Add("urn:bookstore-schema", "books.xsd");
settings.ValidationEventHandler += new ValidationEventHandler (ValidationCallBack);

// Create a validating reader that wraps the XmlNodeReader object.
XmlReader reader = XmlReader.Create(nodeReader, settings);
// Parse the XML file.
while (reader.Read());

' Create the XmlNodeReader object.
Dim doc As New XmlDocument()
doc.Load("books.xml")
Dim nodeReader As New XmlNodeReader(doc)

' Set the validation settings.
Dim settings As New XmlReaderSettings()
settings.ValidationType = ValidationType.Schema
settings.Schemas.Add("urn:bookstore-schema", "books.xsd")
AddHandler settings.ValidationEventHandler, AddressOf ValidationCallBack

' Create a validating reader that wraps the XmlNodeReader object.
Dim reader As XmlReader = XmlReader.Create(nodeReader, settings)
' Parse the XML file.
While reader.Read()
End While

注釈

このメソッドを使用すると、基になる XmlReader オブジェクトに追加の機能を追加できます。 基になるXmlReader オブジェクトには、Create メソッドによって作成された別のXmlReader オブジェクト、または具象XmlReader実装のいずれかを使用して作成されたXmlReader オブジェクトを指定できます。

資格情報のない既定の XmlUrlResolver は、スキーマなどの外部リソースにアクセスするために使用されます。

Important

.NET Framework 4.5.2 以降では、既定の XmlUrlResolver は提供されません。 ソリューションが .NET Framework 4.5.2 以降のバージョンを対象とする場合は、XmlReaderSettings.XmlResolver プロパティを使用してXmlResolverを指定します。

認証が必要なネットワーク リソースに外部リソースがある場合は、XmlReaderSettings.XmlResolver プロパティを使用して、必要な資格情報を持つXmlResolverを指定します。

Important

次のいずれかの方法を使用して、 XmlReader がアクセスできるリソースを制御できます。

• XmlReader プロパティをXmlResolver オブジェクトに設定して、XmlSecureResolverがアクセスできるリソースを制限します。

-又は-

• XmlReader プロパティを XmlResolver に設定して、nullが外部リソースを開くことを許可しないでください。

作成された XmlReader オブジェクトは、エンティティ参照を拡張し、改行文字の XML 正規化を実行します。

Create(TextReader, XmlReaderSettings, String)

ソース:

XmlReader.cs

指定したテキスト リーダー、設定、およびベース URI を使用して、新しい XmlReader インスタンスを作成します。

public:
 static System::Xml::XmlReader ^ Create(System::IO::TextReader ^ input, System::Xml::XmlReaderSettings ^ settings, System::String ^ baseUri);

public static System.Xml.XmlReader Create(System.IO.TextReader input, System.Xml.XmlReaderSettings? settings, string? baseUri);

static member Create : System.IO.TextReader * System.Xml.XmlReaderSettings * string -> System.Xml.XmlReader

Public Shared Function Create (input As TextReader, settings As XmlReaderSettings, baseUri As String) As XmlReader

パラメーター

input

TextReader

XML データの読み取り元のテキスト リーダー。 テキスト リーダーは Unicode 文字のストリームを返します。そのため、XML 宣言で指定されたエンコードは、データ ストリームのデコードに XmlReader では使用されません。

settings

XmlReaderSettings

新しい XmlReader インスタンスの設定。 この値は、null の場合もあります。

baseUri

String

読み取るエンティティまたはドキュメントのベース URI。 この値は、null の場合もあります。

セキュリティに関する注意 ベース URI は、XML ドキュメントの相対 URI を解決するために使用されます。 信頼されていないソースのベース URI は使用しないでください。

戻り値

XmlReader

ストリーム内の XML データを読み取るために使用されるオブジェクト。

例外

ArgumentNullException

input 値は nullです。

注釈

既定では、資格情報のない XmlUrlResolver は、ドキュメント型定義 (DTD)、エンティティ、スキーマなどの外部リソースにアクセスするために使用されます。

Important

.NET Framework 4.5.2 以降では、既定の XmlUrlResolver は提供されません。 ソリューションが .NET Framework 4.5.2 以降のバージョンを対象とする場合は、XmlReaderSettings.XmlResolver プロパティを使用してXmlResolverを指定します。

外部リソースが認証を必要とするネットワーク リソース上にある場合は、 XmlReaderSettings.XmlResolver プロパティを使用して、必要な資格情報で XmlResolver を指定します。

Important

次のいずれかの方法を使用して、 XmlReader がアクセスできるリソースを制御できます。

• XmlReader プロパティをXmlResolver オブジェクトに設定して、XmlSecureResolverがアクセスできるリソースを制限します。

-又は-

• XmlReader プロパティを XmlResolver に設定して、nullが外部リソースを開くことを許可しないでください。

作成された XmlReader オブジェクトは、エンティティ参照を拡張し、改行文字の XML 正規化を実行します。

Create(TextReader, XmlReaderSettings)

ソース:

XmlReader.cs

指定したテキスト リーダーと設定を使用して、新しい XmlReader インスタンスを作成します。

public:
 static System::Xml::XmlReader ^ Create(System::IO::TextReader ^ input, System::Xml::XmlReaderSettings ^ settings);

public static System.Xml.XmlReader Create(System.IO.TextReader input, System.Xml.XmlReaderSettings? settings);

static member Create : System.IO.TextReader * System.Xml.XmlReaderSettings -> System.Xml.XmlReader

Public Shared Function Create (input As TextReader, settings As XmlReaderSettings) As XmlReader

パラメーター

input

TextReader

XML データの読み取り元のテキスト リーダー。 テキスト リーダーは Unicode 文字のストリームを返します。そのため、XML 宣言で指定されたエンコードは、データ ストリームをデコードするために XML リーダーによって使用されません。

settings

XmlReaderSettings

新しい XmlReaderの設定。 この値は、null の場合もあります。

戻り値

XmlReader

ストリーム内の XML データを読み取るために使用されるオブジェクト。

例外

ArgumentNullException

input 値は nullです。

注釈

既定では、資格情報のない XmlUrlResolver は、ドキュメント型定義 (DTD)、エンティティ、スキーマなどの外部リソースにアクセスするために使用されます。

Important

.NET Framework 4.5.2 以降では、既定の XmlUrlResolver は提供されません。 ソリューションが .NET Framework 4.5.2 以降のバージョンを対象とする場合は、XmlReaderSettings.XmlResolver プロパティを使用してXmlResolverを指定します。

外部リソースが認証を必要とするネットワーク リソース上にある場合は、 XmlReaderSettings.XmlResolver プロパティを使用して、必要な資格情報で XmlResolver を指定します。

Important

次のいずれかの方法を使用して、 XmlReader がアクセスできるリソースを制御できます。

• XmlReader プロパティをXmlResolver オブジェクトに設定して、XmlSecureResolverがアクセスできるリソースを制限します。

-又は-

• XmlReader プロパティを XmlResolver に設定して、nullが外部リソースを開くことを許可しないでください。

作成された XmlReader オブジェクトは、エンティティ参照を拡張し、改行文字の XML 正規化を実行します。

Create(Stream, XmlReaderSettings)

ソース:

XmlReader.cs

指定したストリームと設定を使用して、新しい XmlReader インスタンスを作成します。

public:
 static System::Xml::XmlReader ^ Create(System::IO::Stream ^ input, System::Xml::XmlReaderSettings ^ settings);

public static System.Xml.XmlReader Create(System.IO.Stream input, System.Xml.XmlReaderSettings? settings);

static member Create : System.IO.Stream * System.Xml.XmlReaderSettings -> System.Xml.XmlReader

Public Shared Function Create (input As Stream, settings As XmlReaderSettings) As XmlReader

パラメーター

input

Stream

XML データを含むストリーム。

XmlReaderは、ストリームの最初のバイトをスキャンして、バイト オーダー マークまたはその他のエンコード記号を探します。 エンコードが決定されると、エンコードはストリームの読み取りを続行するために使用され、処理は入力を (Unicode) 文字のストリームとして解析し続けます。

settings

XmlReaderSettings

新しい XmlReader インスタンスの設定。 この値は、null の場合もあります。

戻り値

XmlReader

ストリーム内の XML データを読み取るために使用されるオブジェクト。

例外

ArgumentNullException

input 値は nullです。

注釈

既定では、資格情報のない XmlUrlResolver は、ドキュメント型定義 (DTD)、エンティティ、スキーマなどの外部リソースにアクセスするために使用されます。

Important

.NET Framework 4.5.2 以降では、既定の XmlUrlResolver は提供されません。 ソリューションが .NET Framework 4.5.2 以降のバージョンを対象とする場合は、XmlReaderSettings.XmlResolver プロパティを使用してXmlResolverを指定します。

外部リソースが認証を必要とするネットワーク リソース上にある場合は、 XmlReaderSettings.XmlResolver プロパティを使用して、必要な資格情報で XmlResolver を指定します。

Important

次のいずれかの方法を使用して、 XmlReader がアクセスできるリソースを制御できます。

• XmlReader プロパティをXmlResolver オブジェクトに設定して、XmlSecureResolverがアクセスできるリソースを制限します。

-又は-

• XmlReader プロパティを XmlResolver に設定して、nullが外部リソースを開くことを許可しないでください。

作成された XmlReader オブジェクトは、エンティティ参照を拡張し、改行文字の XML 正規化を実行します。

Create(String)

ソース:

XmlReader.cs

指定した URI で新しい XmlReader インスタンスを作成します。

public:
 static System::Xml::XmlReader ^ Create(System::String ^ inputUri);

public static System.Xml.XmlReader Create(string inputUri);

static member Create : string -> System.Xml.XmlReader

Public Shared Function Create (inputUri As String) As XmlReader

パラメーター

inputUri

String

XML データを含むファイルの URI。 XmlUrlResolver クラスは、パスを正規のデータ表現に変換するために使用されます。

戻り値

XmlReader

ストリーム内の XML データを読み取るために使用されるオブジェクト。

例外

ArgumentNullException

inputUri 値は nullです。

SecurityException

XmlReaderには、XML データの場所にアクセスするための十分なアクセス許可がありません。

FileNotFoundException

URI によって識別されるファイルが存在しません。

UriFormatException

URI 形式が正しくありません。

注: .NET for Windows ストア アプリ または ポータブル クラス ライブラリでは、代わりに基底クラスの例外 FormatExceptionキャッチします。

例

次の例では、URI で指定された XML データ ファイルを読み取る XmlReader オブジェクトを作成します。

// Create the XmlReader object.
XmlReader reader = XmlReader.Create("books.xml");

' Create the XmlReader object.
Dim reader As XmlReader = XmlReader.Create("books.xml")

注釈

リーダーの作成には、既定の設定を持つ XmlReaderSettings オブジェクトが使用されます。 作成したリーダーでサポートする機能を指定する場合は、 XmlReaderSettings オブジェクトを引数の 1 つとして受け取るオーバーロードを使用し、正しい設定で XmlReaderSettings オブジェクトを渡します。

資格情報のない既定の XmlUrlResolver は、ドキュメント型定義 (DTD)、エンティティ、スキーマなどの外部リソースにアクセスするために使用されます。

Important

.NET Framework 4.5.2 以降では、既定の XmlUrlResolver は提供されません。 ソリューションが .NET Framework 4.5.2 以降のバージョンを対象とする場合は、XmlReaderSettings.XmlResolver プロパティを使用してXmlResolverを指定します。

認証が必要なネットワーク リソースに外部リソースがある場合は、XmlReaderSettings.XmlResolver プロパティを使用して、必要な資格情報を持つXmlResolverを指定します。

作成された XmlReader オブジェクトは、エンティティ参照を拡張し、改行文字の XML 正規化を実行します。

Create(TextReader)

ソース:

XmlReader.cs

指定したテキスト リーダーを使用して、新しい XmlReader インスタンスを作成します。

public:
 static System::Xml::XmlReader ^ Create(System::IO::TextReader ^ input);

public static System.Xml.XmlReader Create(System.IO.TextReader input);

static member Create : System.IO.TextReader -> System.Xml.XmlReader

Public Shared Function Create (input As TextReader) As XmlReader

パラメーター

input

TextReader

XML データの読み取り元のテキスト リーダー。 テキスト リーダーは Unicode 文字のストリームを返します。そのため、XML 宣言で指定されたエンコードは、データ ストリームをデコードするために XML リーダーによって使用されません。

戻り値

XmlReader

ストリーム内の XML データを読み取るために使用されるオブジェクト。

例外

ArgumentNullException

input 値は nullです。

例

次の例では、 StringReader クラスを使用して XML 文字列を読み取ります。

string xmlData ="<item productID='124390'>" +
                        "<price>5.95</price>" +
                        "</item>";

// Create the XmlReader object.
XmlReader reader = XmlReader.Create(new StringReader(xmlData));

Dim xmlData As String = "<item productID='124390'>" & _ 
                                     "<price>5.95</price>" & _ 
                                     "</item>"

' Create the XmlReader object.
Dim reader As XmlReader = XmlReader.Create(New StringReader(xmlData))

注釈

リーダーの作成には、既定の設定を持つ XmlReaderSettings オブジェクトが使用されます。 作成したリーダーでサポートする機能を指定する場合は、 XmlReaderSettings オブジェクトを引数の 1 つとして受け取るオーバーロードを使用し、正しい設定で XmlReaderSettings オブジェクトを渡します。

資格情報のない既定の XmlUrlResolver は、ドキュメント型定義 (DTD)、エンティティ、スキーマなどの外部リソースにアクセスするために使用されます。

Important

.NET Framework 4.5.2 以降では、既定の XmlUrlResolver は提供されません。 ソリューションが .NET Framework 4.5.2 以降のバージョンを対象とする場合は、XmlReaderSettings.XmlResolver プロパティを使用してXmlResolverを指定します。

認証が必要なネットワーク リソースに外部リソースがある場合は、XmlReaderSettings.XmlResolver プロパティを使用して、必要な資格情報を持つXmlResolverを指定します。

作成された XmlReader オブジェクトは、エンティティ参照を拡張し、改行文字の XML 正規化を実行します。

Create(Stream)

ソース:

XmlReader.cs

既定の設定で指定したストリームを使用して、新しい XmlReader インスタンスを作成します。

public:
 static System::Xml::XmlReader ^ Create(System::IO::Stream ^ input);

public static System.Xml.XmlReader Create(System.IO.Stream input);

static member Create : System.IO.Stream -> System.Xml.XmlReader

Public Shared Function Create (input As Stream) As XmlReader

パラメーター

input

Stream

XML データを含むストリーム。

XmlReaderは、ストリームの最初のバイトをスキャンして、バイト オーダー マークまたはその他のエンコード記号を探します。 エンコードが決定されると、エンコードはストリームの読み取りを続行するために使用され、処理は入力を (Unicode) 文字のストリームとして解析し続けます。

戻り値

XmlReader

ストリーム内の XML データを読み取るために使用されるオブジェクト。

例外

ArgumentNullException

input 値は nullです。

SecurityException

XmlReaderには、XML データの場所にアクセスするための十分なアクセス許可がありません。

例

次の例では、FileStreamから読み取るXmlReader オブジェクトを作成します。

FileStream fs = new FileStream(@"C:\data\books.xml", FileMode.OpenOrCreate,
                                                                    FileAccess.Read, FileShare.Read);

// Create the XmlReader object.
XmlReader reader = XmlReader.Create(fs);

    Dim fs As New FileStream("C:\data\books.xml", FileMode.OpenOrCreate, FileAccess.Read, FileShare.Read)
    
    ' Create the XmlReader object.
    Dim reader As XmlReader = XmlReader.Create(fs)

End Sub

注釈

リーダーの作成には、既定の設定を持つ XmlReaderSettings オブジェクトが使用されます。 作成したリーダーでサポートする機能を指定する場合は、 XmlReaderSettings オブジェクトを引数の 1 つとして受け取るオーバーロードを使用し、正しい設定で XmlReaderSettings オブジェクトを渡します。

資格情報のない既定の XmlUrlResolver は、ドキュメント型定義 (DTD)、エンティティ、スキーマなどの外部リソースにアクセスするために使用されます。

Important

.NET Framework 4.5.2 以降では、既定の XmlUrlResolver は提供されません。 ソリューションが .NET Framework 4.5.2 以降のバージョンを対象とする場合は、XmlReaderSettings.XmlResolver プロパティを使用してXmlResolverを指定します。

認証が必要なネットワーク リソースに外部リソースがある場合は、XmlReaderSettings.XmlResolver プロパティを使用して、必要な資格情報を持つXmlResolverを指定します。

作成された XmlReader オブジェクトは、エンティティ参照を拡張し、改行文字の XML 正規化を実行します。

Create(String, XmlReaderSettings)

ソース:

XmlReader.cs

指定した URI と設定を使用して、新しい XmlReader インスタンスを作成します。

public:
 static System::Xml::XmlReader ^ Create(System::String ^ inputUri, System::Xml::XmlReaderSettings ^ settings);

public static System.Xml.XmlReader Create(string inputUri, System.Xml.XmlReaderSettings? settings);

static member Create : string * System.Xml.XmlReaderSettings -> System.Xml.XmlReader

Public Shared Function Create (inputUri As String, settings As XmlReaderSettings) As XmlReader

パラメーター

inputUri

String

XML データを含むファイルの URI。 XmlReaderSettings オブジェクトのXmlResolver オブジェクトは、パスを正規のデータ表現に変換するために使用されます。 XmlResolverがnullされている場合は、新しいXmlUrlResolver オブジェクトが使用されます。

settings

XmlReaderSettings

新しい XmlReader インスタンスの設定。 この値は、null の場合もあります。

戻り値

XmlReader

ストリーム内の XML データを読み取るために使用されるオブジェクト。

例外

ArgumentNullException

inputUri 値は nullです。

FileNotFoundException

URI で指定されたファイルが見つかりません。

UriFormatException

URI 形式が正しくありません。

注: .NET for Windows ストア アプリ または ポータブル クラス ライブラリでは、代わりに基底クラスの例外 FormatExceptionキャッチします。

例

次の例では、ドキュメント型定義 (DTD) 検証をサポートする XmlReader オブジェクトを作成します。

// Set the validation settings.
XmlReaderSettings settings = new XmlReaderSettings();
settings.DtdProcessing = DtdProcessing.Parse;
settings.ValidationType = ValidationType.DTD;
settings.ValidationEventHandler += new ValidationEventHandler (ValidationCallBack);

 // Create the XmlReader object.
XmlReader reader = XmlReader.Create("itemDTD.xml", settings);

// Parse the file.
while (reader.Read()) {}

' Set the validation settings.
Dim settings As New XmlReaderSettings()
settings.DtdProcessing = DtdProcessing.Parse
settings.ValidationType = ValidationType.DTD
AddHandler settings.ValidationEventHandler, AddressOf ValidationCallBack

' Create the XmlReader object.
Dim reader As XmlReader = XmlReader.Create("itemDTD.xml", settings)

' Parse the file. 
While reader.Read()
End While

注釈

既定では、資格情報のない XmlUrlResolver は、ドキュメント型定義 (DTD)、エンティティ、スキーマなどの外部リソースにアクセスするために使用されます。

Important

.NET Framework 4.5.2 以降では、既定の XmlUrlResolver は提供されません。 ソリューションが .NET Framework 4.5.2 以降のバージョンを対象とする場合は、XmlReaderSettings.XmlResolver プロパティを使用してXmlResolverを指定します。

つまり、 XmlReader は認証を必要としない任意の場所にアクセスできます。 外部リソースが認証を必要とするネットワーク リソース上にある場合は、 XmlReaderSettings.XmlResolver プロパティを使用して、必要な資格情報で XmlResolver を指定します。

Important

XmlResolver プロパティをXmlSecureResolver オブジェクトに設定することで、XmlReaderがアクセスできるリソースを制限できます。

作成された XmlReader オブジェクトは、エンティティ参照を拡張し、改行文字の XML 正規化を実行します。