XmlReader.Create メソッド

定義

新しい XmlReader のインスタンスを作成します。Creates a new XmlReader instance.

オーバーロード

Create(String, XmlReaderSettings, XmlParserContext)

指定された URI、設定、解析するためのコンテキスト情報を使用して、新しい XmlReader インスタンスを作成します。Creates a new XmlReader instance by using the specified URI, settings, and context information for parsing.

Create(TextReader, XmlReaderSettings, XmlParserContext)

指定したテキスト リーダー、設定、および解析するためのコンテキスト情報を使用して、新しい XmlReader インスタンスを作成します。Creates a new XmlReader instance by using the specified text reader, settings, and context information for parsing.

Create(Stream, XmlReaderSettings, XmlParserContext)

解析のために指定されたストリーム、設定、およびコンテキスト情報を使用して、新しい XmlReader インスタンスを作成します。Creates a new XmlReader instance using the specified stream, settings, and context information for parsing.

Create(Stream, XmlReaderSettings, String)

指定されたストリーム、ベース URI、設定を使用して、新しい XmlReader インスタンスを作成します。Creates a new XmlReader instance using the specified stream, base URI, and settings.

Create(XmlReader, XmlReaderSettings)

指定された XML リーダーと設定を使用して新しい XmlReader インスタンスを作成します。Creates a new XmlReader instance by using the specified XML reader and settings.

Create(TextReader, XmlReaderSettings, String)

指定されたテキスト リーダー、設定、およびベース URI を使用して、新しい XmlReader インスタンスを作成します。Creates a new XmlReader instance by using the specified text reader, settings, and base URI.

Create(TextReader, XmlReaderSettings)

指定されたテキスト リーダーと設定を使用して新しい XmlReader インスタンスを作成します。Creates a new XmlReader instance by using the specified text reader and settings.

Create(Stream, XmlReaderSettings)

指定されたストリームと設定で、新しい XmlReader インスタンスを作成します。Creates a new XmlReader instance with the specified stream and settings.

Create(String)

指定された URI で新しい XmlReader インスタンスを作成します。Creates a new XmlReader instance with specified URI.

Create(TextReader)

指定されたテキスト リーダーを使用して新しい XmlReader インスタンスを作成します。Creates a new XmlReader instance by using the specified text reader.

Create(Stream)

既定の設定で指定されたストリームを使用して新しい XmlReader インスタンスを作成します。Creates a new XmlReader instance using the specified stream with default settings.

Create(String, XmlReaderSettings)

指定された URI と設定を使用して新しい XmlReader インスタンスを作成します。Creates a new XmlReader instance by using the specified URI and settings.

この例では、意味のない空白を除去し、コメントを取り除き、フラグメントレベルの一致チェックを実行する XML リーダーを作成します。This example creates an XML reader that strips insignificant white space, strips comments, and performs fragment-level conformance checking.

XmlReaderSettings settings = new XmlReaderSettings();
settings.ConformanceLevel = ConformanceLevel.Fragment;
settings.IgnoreWhitespace = true;
settings.IgnoreComments = true;
XmlReader reader = XmlReader.Create("books.xml", settings);

Dim settings As New XmlReaderSettings()
settings.ConformanceLevel = ConformanceLevel.Fragment
settings.IgnoreWhitespace = true
settings.IgnoreComments = true
Dim reader As XmlReader = XmlReader.Create("books.xml", settings)

次の例ではXmlUrlResolver 、既定の資格情報を持つを使用して、ファイルにアクセスします。The following example uses an XmlUrlResolver with default credentials to access a file.

// Set the reader settings.
XmlReaderSettings^ settings = gcnew XmlReaderSettings;
settings->IgnoreComments = true;
settings->IgnoreProcessingInstructions = true;
settings->IgnoreWhitespace = true;

// Set the reader settings.
XmlReaderSettings settings = new XmlReaderSettings();
settings.IgnoreComments = true;
settings.IgnoreProcessingInstructions = true;
settings.IgnoreWhitespace = true;
' Set the reader settings.
Dim settings as XmlReaderSettings = new XmlReaderSettings()
settings.IgnoreComments = true
settings.IgnoreProcessingInstructions = true
settings.IgnoreWhitespace = true
// Create a resolver with default credentials.
XmlUrlResolver^ resolver = gcnew XmlUrlResolver;
resolver->Credentials = System::Net::CredentialCache::DefaultCredentials;

 // Set the reader settings object to use the resolver.
 settings->XmlResolver = resolver;

// Create the XmlReader object.
XmlReader^ reader = XmlReader::Create( L"http://ServerName/data/books.xml", settings );

  // Create a resolver with default credentials.
  XmlUrlResolver resolver = new XmlUrlResolver();
  resolver.Credentials = System.Net.CredentialCache.DefaultCredentials;

  // Set the reader settings object to use the resolver.
  settings.XmlResolver = resolver;

  // Create the XmlReader object.
  XmlReader reader = XmlReader.Create("http://ServerName/data/books.xml", settings);
' Create a resolver with default credentials.
Dim resolver as XmlUrlResolver = new XmlUrlResolver()
resolver.Credentials = System.Net.CredentialCache.DefaultCredentials

' Set the reader settings object to use the resolver.
settings.XmlResolver = resolver

' Create the XmlReader object.
Dim reader as XmlReader = XmlReader.Create("http://ServerName/data/books.xml", settings)

次のコードでは、リーダーインスタンスを別のリーダー内にラップしています。The following code wraps a reader instance within another reader.

XmlTextReader txtReader = new XmlTextReader("bookOrder.xml");
XmlReaderSettings settings = new XmlReaderSettings();
settings.Schemas.Add("urn:po-schema", "PO.xsd");
settings.ValidationType = ValidationType.Schema;
XmlReader reader = XmlReader.Create(txtReader, settings);

Dim txtReader As XmlTextReader = New XmlTextReader("bookOrder.xml")
Dim settings As New XmlReaderSettings()
settings.Schemas.Add("urn:po-schema", "PO.xsd")
settings.ValidationType = ValidationType.Schema
Dim reader As XmlReader = XmlReader.Create(txtReader, settings)

この例では、リーダーをチェーンして、DTD および XML スキーマ検証を追加します。This example chains readers to add DTD and XML schema validation.

XmlReaderSettings settings = new XmlReaderSettings();
settings.ValidationType = ValidationType.DTD;
XmlReader inner = XmlReader.Create("book.xml", settings); // DTD Validation
settings.Schemas.Add("urn:book-schema", "book.xsd");
settings.ValidationType = ValidationType.Schema;
XmlReader outer = XmlReader.Create(inner, settings);  // XML Schema Validation
Dim settings As New XmlReaderSettings()
settings.ValidationType = ValidationType.DTD
Dim inner As XmlReader = XmlReader.Create("book.xml", settings) ' DTD Validation
settings.Schemas.Add("urn:book-schema", "book.xsd")
settings.ValidationType = ValidationType.Schema
Dim outer As XmlReader = XmlReader.Create(inner, settings)  ' XML Schema Validation

注釈

ほとんどのCreateオーバーロードには、 settings XmlReaderSettingsオブジェクトを受け取るパラメーターが含まれています。Most of the Create overloads include a settings parameter that accepts an XmlReaderSettings object. このオブジェクトを使用して、次のことを行うことができます。You can use this object to:

  • XmlReaderオブジェクトでサポートする機能を指定します。Specify which features you want supported on the XmlReader object.

  • オブジェクトをXmlReaderSettings再利用して、複数のリーダーを作成します。Reuse the XmlReaderSettings object to create multiple readers. 同じ機能を持つ複数のリーダーの作成に、同じ設定を使用できます。You can use the same settings to create multiple readers with the same functionality. または、 XmlReaderSettingsインスタンスの設定を変更し、別の機能セットを使用して新しいリーダーを作成することもできます。Or, you can modify the settings on an XmlReaderSettings instance and create a new reader with a different set of features.

  • 既存の XML リーダーに機能を追加します。Add features to an existing XML reader. Create メソッドは別の XmlReader オブジェクトを受け取ることができます。The Create method can accept another XmlReader object. 基にXmlReaderなるオブジェクトには、ユーザー定義のリーダー XmlTextReader 、オブジェクト、またはXmlReader追加する機能を追加する別のインスタンスを指定できます。The underlying XmlReader object can be a user-defined reader, a XmlTextReader object, or another XmlReader instance that you want to add additional features to.

  • 静的XmlReader メソッドによって作成されたオブジェクトでのみ使用できるXML1.0(第4版)勧告に準拠の確認や準拠などの機能を十分に活用しCreateます。Take full advantage of features such as better conformance checking and compliance to the XML 1.0 (fourth edition) recommendation that are available only on XmlReader objects created by the static Create method.

注意

XmlReader .NET Framework にはXmlTextReaderXmlNodeReaderクラス、クラスCreateXmlReaderクラスなど、クラスの具象実装が含まれていますが、次を使用してインスタンスを作成することをお勧めします。 XmlValidatingReaderb.Although the .NET Framework includes concrete implementations of the XmlReader class, such as the XmlTextReader, XmlNodeReader, and the XmlValidatingReader classes, we recommend that you create XmlReader instances by using the Create method.

既定の設定Default settings

オブジェクトをCreate XmlReaderSettings受け入れないオーバーロードを使用する場合は、次の既定のリーダー設定が使用されます。If you use a Create overload that doesn't accept a XmlReaderSettings object, the following default reader settings are used:

設定Setting 既定値Default
CheckCharacters true
ConformanceLevel ConformanceLevel.Document
IgnoreComments false
IgnoreProcessingInstructions false
IgnoreWhitespace false
LineNumberOffset 00
LinePositionOffset 00
NameTable null
DtdProcessing Prohibit
Schemas 空の XmlSchemaSet オブジェクトAn empty XmlSchemaSet object
ValidationFlags ProcessIdentityConstraintsenabledProcessIdentityConstraints enabled
ValidationType None
XmlResolver 新しい XmlUrlResolver オブジェクト。A new XmlUrlResolver object. .NET Framework 4.5.2 以降では、この設定のnull既定値はです。Starting with the .NET Framework 4.5.2, this setting has a default value of null.

一般的なシナリオの設定Settings for common scenarios

いくつかの一般的な XML リーダーのシナリオでは、次のプロパティを設定する必要があります。XmlReaderSettingsHere are the XmlReaderSettings properties you should set for some of the typical XML reader scenarios.

必要条件Requirement 設定Set
データは、整形式の XML ドキュメントである必要があります。Data must be a well-formed XML document. ConformanceLevelDocumentにします。ConformanceLevel to Document.
データは、整形式の XML で解析されたエンティティである必要があります。Data must be a well-formed XML parsed entity. ConformanceLevelFragmentにします。ConformanceLevel to Fragment.
データは DTD に対して検証する必要があります。Data must be validated against a DTD. DtdProcessingParseDtdProcessing to Parse
ValidationTypeDTDにします。ValidationType to DTD.
XML スキーマに対してデータを検証する必要があります。Data must be validated against an XML schema. ValidationTypeSchemaValidationType to Schema
Schemas検証に使用する。 XmlSchemaSetSchemas to the XmlSchemaSet to use for validation. は、 XmlReader XML データ削減 (XDR) スキーマ検証をサポートしていないことに注意してください。Note that XmlReader doesn't support XML-Data Reduced (XDR) schema validation.
インライン XML スキーマに対してデータを検証する必要があります。Data must be validated against an inline XML schema. ValidationTypeSchemaValidationType to Schema
ValidationFlagsProcessInlineSchemaにします。ValidationFlags to ProcessInlineSchema.
型のサポート。Type support. ValidationTypeSchemaValidationType to Schema
Schemasを使用XmlSchemaSetするには。Schemas to the XmlSchemaSet to use.

XmlReaderでは、XML データ削減 (XDR) スキーマ検証はサポートされていません。XmlReader doesn't support XML-Data Reduced (XDR) schema validation.

非同期プログラミングAsynchronous programming

同期モードでは、 Createメソッドは、ファイル、ストリーム、またはテキストリーダーのバッファーからデータの最初のチャンクを読み取ります。In synchronous mode, the Create method reads the first chunk of data from the buffer of the file, stream, or text reader. I/o 操作が失敗した場合は、例外がスローされることがあります。This may throw an exception if an I/O operation fails. 非同期モードでは、最初の i/o 操作が読み取り操作で発生します。そのため、読み取り操作が行われると、発生した例外がスローされます。In asynchronous mode, the first I/O operation occurs with a read operation, so exceptions that arise will be thrown when the read operation occurs.

セキュリティの考慮事項Security considerations

既定では、 XmlReaderは、 XmlUrlResolverリソースを開くためにユーザー資格情報のないオブジェクトを使用します。By default, the XmlReader uses an XmlUrlResolver object with no user credentials to open resources. つまり、既定では、XML リーダーは、資格情報を必要としない任意の場所にアクセスできます。This means that, by default, the XML reader can access any location that doesn't require credentials. リソースへXmlResolverのアクセスを制御するには、プロパティを使用します。Use the XmlResolver property to control access to resources:

- または --or-

  • XML XmlResolverリーダー nullが外部リソースを開けないようにするには、をに設定します。Set XmlResolver to null to prevent the XML reader from opening any external resources.

Create(String, XmlReaderSettings, XmlParserContext)

指定された URI、設定、解析するためのコンテキスト情報を使用して、新しい XmlReader インスタンスを作成します。Creates a new XmlReader instance by using the specified URI, settings, and context information for parsing.

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。The URI for the file containing the XML data. XmlReaderSettings オブジェクト上の XmlResolver オブジェクトは、パスを正規データ形式に変換するときに使用されます。The XmlResolver object on the XmlReaderSettings object is used to convert the path to a canonical data representation. XmlResolvernull の場合は、新しい XmlUrlResolver オブジェクトが使用されます。If XmlResolver is null, a new XmlUrlResolver object is used.

settings
XmlReaderSettings

新しい XmlReader インスタンスの設定。The settings for the new XmlReader instance. この値は、null の場合もあります。This value can be null.

inputContext
XmlParserContext

XML フラグメントの解析に必要なコンテキスト情報。The context information required to parse the XML fragment. コンテキスト情報には、使用する XmlNameTable、エンコーディング、名前空間スコープ、現在の xml:langxml:space のスコープ、ベース URI、およびドキュメント型定義を格納できます。The context information can include the XmlNameTable to use, encoding, namespace scope, the current xml:lang and xml:space scope, base URI, and document type definition.

この値は、null の場合もあります。This value can be null.

戻り値

ストリーム内の XML データの読み取りに使用するオブジェクト。An object that is used to read the XML data in the stream.

例外

inputUri 値は null です。The inputUri value is null.

XmlReader には、XML データの場所にアクセスするための十分なアクセス許可がありません。The XmlReader does not have sufficient permissions to access the location of the XML data.

NameTable プロパティと NameTable プロパティの両方に値が含まれています。The NameTable and NameTable properties both contain values. (これらの NameTable プロパティの 1 つのみを設定して使用できます。)(Only one of these NameTable properties can be set and used).

URI で指定したファイルが見つかりません。The file specified by the URI cannot be found.

URI の形式が正しくありません。The URI format is not correct.

注釈

既定ではXmlUrlResolver 、資格情報なしのは、ドキュメント型定義 (DTD)、エンティティ、スキーマなどの外部リソースへのアクセスに使用されます。By default an XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

重要

.NET Framework 4.5.2 以降では、既定値XmlUrlResolverは指定されていません。Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. ソリューションが .NET Framework 4.5.2 以降のバージョンを対象としているXmlResolver場合はXmlReaderSettings.XmlResolver 、プロパティを使用してを指定します。If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

これは、 XmlReaderが認証を必要としない任意の場所にアクセスできることを意味します。This means that the XmlReader can access any locations that does not require authentication. 外部リソースが認証を必要とするネットワークリソースに配置されているXmlReaderSettings.XmlResolver場合は、プロパティXmlResolverを使用して、必要な資格情報を持つを指定します。If the external resource is located on a network resource that requires authentication, use the XmlReaderSettings.XmlResolver property to specify an XmlResolver with the necessary credentials.

重要

がアクセスXmlReaderできるリソースを制限するには、 XmlResolverプロパティをXmlSecureResolverオブジェクトに設定します。You can restrict the resources that the XmlReader can access by setting the XmlResolver property to an XmlSecureResolver object.

作成さXmlReaderれたオブジェクトは、エンティティ参照を展開し、改行文字の XML 正規化を実行します。The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(TextReader, XmlReaderSettings, XmlParserContext)

指定したテキスト リーダー、設定、および解析するためのコンテキスト情報を使用して、新しい XmlReader インスタンスを作成します。Creates a new XmlReader instance by using the specified text reader, settings, and context information for parsing.

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 データの読み出し元のテキスト リーダー。The text reader from which to read the XML data. テキスト リーダーは Unicode 文字のストリームを返すため、XML リーダーはデータ ストリームのデコードに XML 宣言に指定されたエンコーディングを使用しません。A text reader returns a stream of Unicode characters, so the encoding specified in the XML declaration isn't used by the XML reader to decode the data stream.

settings
XmlReaderSettings

新しい XmlReader インスタンスの設定。The settings for the new XmlReader instance. この値は、null の場合もあります。This value can be null.

inputContext
XmlParserContext

XML フラグメントの解析に必要なコンテキスト情報。The context information required to parse the XML fragment. コンテキスト情報には、使用する XmlNameTable、エンコーディング、名前空間スコープ、現在の xml:langxml:space のスコープ、ベース URI、およびドキュメント型定義を格納できます。The context information can include the XmlNameTable to use, encoding, namespace scope, the current xml:lang and xml:space scope, base URI, and document type definition.

この値は、null の場合もあります。This value can be null.

戻り値

ストリーム内の XML データの読み取りに使用するオブジェクト。An object that is used to read the XML data in the stream.

例外

input 値は null です。The input value is null.

NameTable プロパティと NameTable プロパティの両方に値が含まれています。The NameTable and NameTable properties both contain values. (これらの NameTable プロパティの 1 つのみを設定して使用できます。)(Only one of these NameTable properties can be set and used).

次の例ではXmlReader 、XML フラグメントを読み取るオブジェクトを作成します。The following example creates an XmlReader object that reads an XML fragment.

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)、エンティティ、スキーマなどの外部リソースへのアクセスに使用されます。By default an XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

重要

.NET Framework 4.5.2 以降では、既定値XmlUrlResolverは指定されていません。Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. ソリューションが .NET Framework 4.5.2 以降のバージョンを対象としているXmlResolver場合はXmlReaderSettings.XmlResolver 、プロパティを使用してを指定します。If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

外部リソースが認証を必要とするネットワークリソースに配置されているXmlReaderSettings.XmlResolver場合は、プロパティXmlResolverを使用して、必要な資格情報を持つを指定します。If the external resource is located on a network resource that requires authentication, use the XmlReaderSettings.XmlResolver property to specify an XmlResolver with the necessary credentials.

重要

次のいずれかの方法を使用して、 XmlReaderがアクセスできるリソースを制御できます。You can use one of the following methods to control which resources the XmlReader can access:

または-or-

  • XmlReader プロパティを XmlResolver に設定することにより、null が外部リソースを開けないようにする。Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

作成さXmlReaderれたオブジェクトは、エンティティ参照を展開し、改行文字の XML 正規化を実行します。The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(Stream, XmlReaderSettings, XmlParserContext)

解析のために指定されたストリーム、設定、およびコンテキスト情報を使用して、新しい XmlReader インスタンスを作成します。Creates a new XmlReader instance using the specified stream, settings, and context information for parsing.

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 データを格納しているストリーム。The stream that contains the XML data.

XmlReader は、バイト オーダー マークや、エンコードに関するその他の記号を探すため、ストリームの先頭バイトをスキャンします。The XmlReader scans the first bytes of the stream looking for a byte order mark or other sign of encoding. エンコーディングが確認された場合、そのエンコーディングを使用してストリームの読み込みを続行し、入力を (Unicode) 文字のストリームとして解析する処理を継続します。When encoding is determined, the encoding is used to continue reading the stream, and processing continues parsing the input as a stream of (Unicode) characters.

settings
XmlReaderSettings

新しい XmlReader インスタンスの設定。The settings for the new XmlReader instance. この値は、null の場合もあります。This value can be null.

inputContext
XmlParserContext

XML フラグメントの解析に必要なコンテキスト情報。The context information required to parse the XML fragment. コンテキスト情報には、使用する XmlNameTable、エンコーディング、名前空間スコープ、現在の xml:langxml:space のスコープ、ベース URI、およびドキュメント型定義を格納できます。The context information can include the XmlNameTable to use, encoding, namespace scope, the current xml:lang and xml:space scope, base URI, and document type definition.

この値は、null の場合もあります。This value can be null.

戻り値

ストリーム内の XML データの読み取りに使用するオブジェクト。An object that is used to read the XML data in the stream.

例外

input 値は null です。The input value is null.

注釈

既定ではXmlUrlResolver 、資格情報なしのは、ドキュメント型定義 (DTD)、エンティティ、スキーマなどの外部リソースへのアクセスに使用されます。By default an XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

重要

.NET Framework 4.5.2 以降では、既定値XmlUrlResolverは指定されていません。Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. ソリューションが .NET Framework 4.5.2 以降のバージョンを対象としているXmlResolver場合はXmlReaderSettings.XmlResolver 、プロパティを使用してを指定します。If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

外部リソースが認証を必要とするネットワークリソースに配置されているXmlReaderSettings.XmlResolver場合は、プロパティXmlResolverを使用して、必要な資格情報を持つを指定します。If the external resource is located on a network resource that requires authentication, use the XmlReaderSettings.XmlResolver property to specify an XmlResolver with the necessary credentials.

重要

次のいずれかの方法を使用して、 XmlReaderがアクセスできるリソースを制御できます。You can use one of the following methods to control which resources the XmlReader can access:

または-or-

  • XmlReader プロパティを XmlResolver に設定することにより、null が外部リソースを開けないようにする。Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

作成さXmlReaderれたオブジェクトは、エンティティ参照を展開し、改行文字の XML 正規化を実行します。The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(Stream, XmlReaderSettings, String)

指定されたストリーム、ベース URI、設定を使用して、新しい XmlReader インスタンスを作成します。Creates a new XmlReader instance using the specified stream, base URI, and settings.

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 データを格納しているストリーム。The stream that contains the XML data.

XmlReader は、バイト オーダー マークや、エンコードに関するその他の記号を探すため、ストリームの先頭バイトをスキャンします。The XmlReader scans the first bytes of the stream looking for a byte order mark or other sign of encoding. エンコーディングが確認された場合、そのエンコーディングを使用してストリームの読み込みを続行し、入力を (Unicode) 文字のストリームとして解析する処理を継続します。When encoding is determined, the encoding is used to continue reading the stream, and processing continues parsing the input as a stream of (Unicode) characters.

settings
XmlReaderSettings

新しい XmlReader インスタンスの設定。The settings for the new XmlReader instance. この値は、null の場合もあります。This value can be null.

baseUri
String

読み取るエンティティまたはドキュメントのベース URI。The base URI for the entity or document being read. この値は、null の場合もあります。This value can be null.

セキュリティに関するメモ ベース URI は、XML ドキュメントの相対 URI を解決するために使用されます。Security Note The base URI is used to resolve the relative URI of the XML document. 信頼関係のないソースからベース URI を使用することは避けてください。Do not use a base URI from an untrusted source.

戻り値

ストリーム内の XML データの読み取りに使用するオブジェクト。An object that is used to read the XML data in the stream.

例外

input 値は null です。The input value is null.

注釈

既定ではXmlUrlResolver 、資格情報なしのは、ドキュメント型定義 (DTD)、エンティティ、スキーマなどの外部リソースへのアクセスに使用されます。By default an XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

重要

.NET Framework 4.5.2 以降では、既定値XmlUrlResolverは指定されていません。Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. ソリューションが .NET Framework 4.5.2 以降のバージョンを対象としているXmlResolver場合はXmlReaderSettings.XmlResolver 、プロパティを使用してを指定します。If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

外部リソースが認証を必要とするネットワークリソースに配置されているXmlReaderSettings.XmlResolver場合は、プロパティXmlResolverを使用して、必要な資格情報を持つを指定します。If the external resource is located on a network resource that requires authentication, use the XmlReaderSettings.XmlResolver property to specify an XmlResolver with the necessary credentials.

重要

次のいずれかの方法を使用して、 XmlReaderがアクセスできるリソースを制御できます。You can use one of the following methods to control which resources the XmlReader can access:

- または --or-

  • XmlReader プロパティを XmlResolver に設定することにより、null が外部リソースを開けないようにする。Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

作成さXmlReaderれたオブジェクトは、エンティティ参照を展開し、改行文字の XML 正規化を実行します。The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(XmlReader, XmlReaderSettings)

指定された XML リーダーと設定を使用して新しい XmlReader インスタンスを作成します。Creates a new XmlReader instance by using the specified XML reader and settings.

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 リーダーとして使用するオブジェクト。The object that you want to use as the underlying XML reader.

settings
XmlReaderSettings

新しい XmlReader インスタンスの設定。The settings for the new XmlReader instance.

XmlReaderSettings オブジェクトの準拠レベルは、基になるリーダーの準拠レベルと一致するか、Auto に設定する必要があります。The conformance level of the XmlReaderSettings object must either match the conformance level of the underlying reader, or it must be set to Auto.

戻り値

指定された XmlReader オブジェクトをラップするオブジェクト。An object that is wrapped around the specified XmlReader object.

例外

reader 値は null です。The reader value is null.

XmlReaderSettings オブジェクトが、基になるリーダーの準拠レベルと一致しない準拠レベルを指定した場合。If the XmlReaderSettings object specifies a conformance level that is not consistent with conformance level of the underlying reader.

- または --or- 基になる XmlReaderError 状態か Closed 状態。The underlying XmlReader is in an Error or Closed state.

次の例では、 XmlReader XmlNodeReaderオブジェクトをラップする検証オブジェクトを作成します。The following example creates a validating XmlReader object that is wrapped around an XmlNodeReader object.

// 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オブジェクトに機能を追加できます。This method allows you add additional features to an underlying XmlReader object. 基にXmlReaderなるオブジェクトは、 XmlReader CreateメソッドXmlReaderによって作成された別のオブジェクトでも、具象XmlReader実装の1つを使用して作成されたオブジェクトでもかまいません。The underlying XmlReader object can be another XmlReader object created by the Create method, or an XmlReader object created using one of the concrete XmlReader implementations.

資格情報XmlUrlResolverなしの既定値は、スキーマなどの外部リソースへのアクセスに使用されます。A default XmlUrlResolver with no credentials is used to access any external resources such as a schema.

重要

.NET Framework 4.5.2 以降では、既定値XmlUrlResolverは指定されていません。Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. ソリューションが .NET Framework 4.5.2 以降のバージョンを対象としているXmlResolver場合はXmlReaderSettings.XmlResolver 、プロパティを使用してを指定します。If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

外部リソースが認証を必要とするネットワークリソースに配置されているXmlResolver場合は、 XmlReaderSettings.XmlResolverプロパティを使用して、必要な資格情報を持つを指定します。If the external resource is located on a network resource that requires authentication, specify an XmlResolver with the necessary credentials using the XmlReaderSettings.XmlResolver property.

重要

次のいずれかの方法を使用して、 XmlReaderがアクセスできるリソースを制御できます。You can use one of the following methods to control which resources the XmlReader can access:

- または --or-

  • XmlReader プロパティを XmlResolver に設定することにより、null が外部リソースを開けないようにする。Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

作成さXmlReaderれたオブジェクトは、エンティティ参照を展開し、改行文字の XML 正規化を実行します。The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(TextReader, XmlReaderSettings, String)

指定されたテキスト リーダー、設定、およびベース URI を使用して、新しい XmlReader インスタンスを作成します。Creates a new XmlReader instance by using the specified text reader, settings, and base URI.

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 データの読み出し元のテキスト リーダー。The text reader from which to read the XML data. テキスト リーダーは Unicode 文字のストリームを返すため、XmlReader は XML 宣言に指定されたエンコーディングをデータ ストリームのデコードに使用しません。A text reader returns a stream of Unicode characters, so the encoding specified in the XML declaration isn't used by the XmlReader to decode the data stream.

settings
XmlReaderSettings

新しい XmlReader インスタンスの設定。The settings for the new XmlReader instance. この値は、null の場合もあります。This value can be null.

baseUri
String

読み取るエンティティまたはドキュメントのベース URI。The base URI for the entity or document being read. この値は、null の場合もあります。This value can be null.

セキュリティに関するメモ ベース URI は、XML ドキュメントの相対 URI を解決するために使用されます。Security Note The base URI is used to resolve the relative URI of the XML document. 信頼関係のないソースからベース URI を使用することは避けてください。Do not use a base URI from an untrusted source.

戻り値

ストリーム内の XML データの読み取りに使用するオブジェクト。An object that is used to read the XML data in the stream.

例外

input 値は null です。The input value is null.

注釈

既定ではXmlUrlResolver 、資格情報なしのは、ドキュメント型定義 (DTD)、エンティティ、スキーマなどの外部リソースへのアクセスに使用されます。By default an XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

重要

.NET Framework 4.5.2 以降では、既定値XmlUrlResolverは指定されていません。Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. ソリューションが .NET Framework 4.5.2 以降のバージョンを対象としているXmlResolver場合はXmlReaderSettings.XmlResolver 、プロパティを使用してを指定します。If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

外部リソースが認証を必要とするネットワークリソースに配置されているXmlReaderSettings.XmlResolver場合は、プロパティXmlResolverを使用して、必要な資格情報を持つを指定します。If the external resource is located on a network resource that requires authentication, use the XmlReaderSettings.XmlResolver property to specify an XmlResolver with the necessary credentials.

重要

次のいずれかの方法を使用して、 XmlReaderがアクセスできるリソースを制御できます。You can use one of the following methods to control which resources the XmlReader can access:

- または --or-

  • XmlReader プロパティを XmlResolver に設定することにより、null が外部リソースを開けないようにする。Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

作成さXmlReaderれたオブジェクトは、エンティティ参照を展開し、改行文字の XML 正規化を実行します。The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(TextReader, XmlReaderSettings)

指定されたテキスト リーダーと設定を使用して新しい XmlReader インスタンスを作成します。Creates a new XmlReader instance by using the specified text reader and settings.

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 データの読み出し元のテキスト リーダー。The text reader from which to read the XML data. テキスト リーダーは Unicode 文字のストリームを返すため、XML リーダーはデータ ストリームのデコードに XML 宣言に指定されたエンコーディングを使用しません。A text reader returns a stream of Unicode characters, so the encoding specified in the XML declaration isn't used by the XML reader to decode the data stream.

settings
XmlReaderSettings

新しい XmlReader の設定。The settings for the new XmlReader. この値は、null の場合もあります。This value can be null.

戻り値

ストリーム内の XML データの読み取りに使用するオブジェクト。An object that is used to read the XML data in the stream.

例外

input 値は null です。The input value is null.

注釈

既定ではXmlUrlResolver 、資格情報なしのは、ドキュメント型定義 (DTD)、エンティティ、スキーマなどの外部リソースへのアクセスに使用されます。By default an XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

重要

.NET Framework 4.5.2 以降では、既定値XmlUrlResolverは指定されていません。Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. ソリューションが .NET Framework 4.5.2 以降のバージョンを対象としているXmlResolver場合はXmlReaderSettings.XmlResolver 、プロパティを使用してを指定します。If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

外部リソースが認証を必要とするネットワークリソースに配置されているXmlReaderSettings.XmlResolver場合は、プロパティXmlResolverを使用して、必要な資格情報を持つを指定します。If the external resource is located on a network resource that requires authentication, use the XmlReaderSettings.XmlResolver property to specify an XmlResolver with the necessary credentials.

重要

次のいずれかの方法を使用して、 XmlReaderがアクセスできるリソースを制御できます。You can use one of the following methods to control which resources the XmlReader can access:

- または --or-

  • XmlReader プロパティを XmlResolver に設定することにより、null が外部リソースを開けないようにする。Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

作成さXmlReaderれたオブジェクトは、エンティティ参照を展開し、改行文字の XML 正規化を実行します。The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(Stream, XmlReaderSettings)

指定されたストリームと設定で、新しい XmlReader インスタンスを作成します。Creates a new XmlReader instance with the specified stream and settings.

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 データを格納しているストリーム。The stream that contains the XML data.

XmlReader は、バイト オーダー マークや、エンコードに関するその他の記号を探すため、ストリームの先頭バイトをスキャンします。The XmlReader scans the first bytes of the stream looking for a byte order mark or other sign of encoding. エンコーディングが確認された場合、そのエンコーディングを使用してストリームの読み込みを続行し、入力を (Unicode) 文字のストリームとして解析する処理を継続します。When encoding is determined, the encoding is used to continue reading the stream, and processing continues parsing the input as a stream of (Unicode) characters.

settings
XmlReaderSettings

新しい XmlReader インスタンスの設定。The settings for the new XmlReader instance. この値は、null の場合もあります。This value can be null.

戻り値

ストリーム内の XML データの読み取りに使用するオブジェクト。An object that is used to read the XML data in the stream.

例外

input 値は null です。The input value is null.

注釈

既定ではXmlUrlResolver 、資格情報なしのは、ドキュメント型定義 (DTD)、エンティティ、スキーマなどの外部リソースへのアクセスに使用されます。By default an XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

重要

.NET Framework 4.5.2 以降では、既定値XmlUrlResolverは指定されていません。Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. ソリューションが .NET Framework 4.5.2 以降のバージョンを対象としているXmlResolver場合はXmlReaderSettings.XmlResolver 、プロパティを使用してを指定します。If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

外部リソースが認証を必要とするネットワークリソースに配置されているXmlReaderSettings.XmlResolver場合は、プロパティXmlResolverを使用して、必要な資格情報を持つを指定します。If the external resource is located on a network resource that requires authentication, use the XmlReaderSettings.XmlResolver property to specify an XmlResolver with the necessary credentials.

重要

次のいずれかの方法を使用して、 XmlReaderがアクセスできるリソースを制御できます。You can use one of the following methods to control which resources the XmlReader can access:

- または --or-

  • XmlReader プロパティを XmlResolver に設定することにより、null が外部リソースを開けないようにする。Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

作成さXmlReaderれたオブジェクトは、エンティティ参照を展開し、改行文字の XML 正規化を実行します。The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(String)

指定された URI で新しい XmlReader インスタンスを作成します。Creates a new XmlReader instance with specified URI.

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。The URI for the file that contains the XML data. XmlUrlResolver クラスは、パスを正規データ形式に変換するときに使用されます。The XmlUrlResolver class is used to convert the path to a canonical data representation.

戻り値

ストリーム内の XML データの読み取りに使用するオブジェクト。An object that is used to read the XML data in the stream.

例外

inputUri 値は null です。The inputUri value is null.

XmlReader には、XML データの場所にアクセスするための十分なアクセス許可がありません。The XmlReader does not have sufficient permissions to access the location of the XML data.

URI によって識別されるファイルが存在しません。The file identified by the URI does not exist.

Windows ストア アプリ用 .NET またはポータブル クラス ライブラリでは、基本クラスの例外である FormatException を代わりにキャッチします。In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, FormatException, instead.

URI の形式が正しくありません。The URI format is not correct.

次の例ではXmlReader 、URI で指定された XML データファイルを読み取るオブジェクトを作成します。The following example creates an XmlReader object that reads XML data file specified by the URI.

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

注釈

既定の設定を持つオブジェクトは、リーダーの作成に使用されます。XmlReaderSettingsAn XmlReaderSettings object with default settings is used to create the reader. 作成されたリーダーでサポートする機能を指定する場合は、 XmlReaderSettingsオブジェクトを引数の1つとして受け取るオーバーロードを使用し、正しい設定のXmlReaderSettingsオブジェクトを渡します。If you wish to specify the features to support on the created reader, use the overload that takes an XmlReaderSettings object as one of its arguments, and pass in an XmlReaderSettings object with the correct settings.

資格情報XmlUrlResolverなしの既定値は、ドキュメント型定義 (DTD)、エンティティ、スキーマなどの外部リソースへのアクセスに使用されます。A default XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

重要

.NET Framework 4.5.2 以降では、既定値XmlUrlResolverは指定されていません。Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. ソリューションが .NET Framework 4.5.2 以降のバージョンを対象としているXmlResolver場合はXmlReaderSettings.XmlResolver 、プロパティを使用してを指定します。If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

外部リソースが認証を必要とするネットワークリソースに配置されているXmlResolver場合は、 XmlReaderSettings.XmlResolverプロパティを使用して、必要な資格情報を持つを指定します。If the external resource is located on a network resource that requires authentication, specify an XmlResolver with the necessary credentials using the XmlReaderSettings.XmlResolver property.

作成さXmlReaderれたオブジェクトは、エンティティ参照を展開し、改行文字の XML 正規化を実行します。The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(TextReader)

指定されたテキスト リーダーを使用して新しい XmlReader インスタンスを作成します。Creates a new XmlReader instance by using the specified text reader.

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 データの読み出し元のテキスト リーダー。The text reader from which to read the XML data. テキスト リーダーは Unicode 文字のストリームを返すため、XML リーダーはデータ ストリームのデコードに XML 宣言に指定されたエンコーディングを使用しません。A text reader returns a stream of Unicode characters, so the encoding specified in the XML declaration is not used by the XML reader to decode the data stream.

戻り値

ストリーム内の XML データの読み取りに使用するオブジェクト。An object that is used to read the XML data in the stream.

例外

input 値は null です。The input value is null.

次の例ではStringReader 、クラスを使用して XML 文字列を読み取ります。The following example uses the StringReader class to read an XML string.

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))

注釈

既定の設定を持つオブジェクトは、リーダーの作成に使用されます。XmlReaderSettingsAn XmlReaderSettings object with default settings is used to create the reader. 作成されたリーダーでサポートする機能を指定する場合は、 XmlReaderSettingsオブジェクトを引数の1つとして受け取るオーバーロードを使用し、正しい設定のXmlReaderSettingsオブジェクトを渡します。If you wish to specify the features to support on the created reader, use the overload that takes an XmlReaderSettings object as one of its arguments, and pass in an XmlReaderSettings object with the correct settings.

資格情報XmlUrlResolverなしの既定値は、ドキュメント型定義 (DTD)、エンティティ、スキーマなどの外部リソースへのアクセスに使用されます。A default XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

重要

.NET Framework 4.5.2 以降では、既定値XmlUrlResolverは指定されていません。Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. ソリューションが .NET Framework 4.5.2 以降のバージョンを対象としているXmlResolver場合はXmlReaderSettings.XmlResolver 、プロパティを使用してを指定します。If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

外部リソースが認証を必要とするネットワークリソースに配置されているXmlResolver場合は、 XmlReaderSettings.XmlResolverプロパティを使用して、必要な資格情報を持つを指定します。If the external resource is located on a network resource that requires authentication, specify an XmlResolver with the necessary credentials using the XmlReaderSettings.XmlResolver property.

作成さXmlReaderれたオブジェクトは、エンティティ参照を展開し、改行文字の XML 正規化を実行します。The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(Stream)

既定の設定で指定されたストリームを使用して新しい XmlReader インスタンスを作成します。Creates a new XmlReader instance using the specified stream with default settings.

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 データを格納しているストリーム。The stream that contains the XML data.

XmlReader は、バイト オーダー マークや、エンコードに関するその他の記号を探すため、ストリームの先頭バイトをスキャンします。The XmlReader scans the first bytes of the stream looking for a byte order mark or other sign of encoding. エンコーディングが確認された場合、そのエンコーディングを使用してストリームの読み込みを続行し、入力を (Unicode) 文字のストリームとして解析する処理を継続します。When encoding is determined, the encoding is used to continue reading the stream, and processing continues parsing the input as a stream of (Unicode) characters.

戻り値

ストリーム内の XML データの読み取りに使用するオブジェクト。An object that is used to read the XML data in the stream.

例外

input 値は null です。The input value is null.

XmlReader には、XML データの場所にアクセスするための十分なアクセス許可がありません。The XmlReader does not have sufficient permissions to access the location of the XML data.

次の例ではXmlReaderFileStreamから読み取るオブジェクトを作成します。The following example creates an XmlReader object that reads from a FileStream.


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

注釈

既定の設定を持つオブジェクトは、リーダーの作成に使用されます。XmlReaderSettingsAn XmlReaderSettings object with default settings is used to create the reader. 作成されたリーダーでサポートする機能を指定する場合は、 XmlReaderSettingsオブジェクトを引数の1つとして受け取るオーバーロードを使用し、正しい設定のXmlReaderSettingsオブジェクトを渡します。If you wish to specify the features to support on the created reader, use the overload that takes an XmlReaderSettings object as one of its arguments, and pass in an XmlReaderSettings object with the correct settings.

資格情報XmlUrlResolverなしの既定値は、ドキュメント型定義 (DTD)、エンティティ、スキーマなどの外部リソースへのアクセスに使用されます。A default XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

重要

.NET Framework 4.5.2 以降では、既定値XmlUrlResolverは指定されていません。Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. ソリューションが .NET Framework 4.5.2 以降のバージョンを対象としているXmlResolver場合はXmlReaderSettings.XmlResolver 、プロパティを使用してを指定します。If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

外部リソースが認証を必要とするネットワークリソースに配置されているXmlResolver場合は、 XmlReaderSettings.XmlResolverプロパティを使用して、必要な資格情報を持つを指定します。If the external resource is located on a network resource that requires authentication, specify an XmlResolver with the necessary credentials using the XmlReaderSettings.XmlResolver property.

作成さXmlReaderれたオブジェクトは、エンティティ参照を展開し、改行文字の XML 正規化を実行します。The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(String, XmlReaderSettings)

指定された URI と設定を使用して新しい XmlReader インスタンスを作成します。Creates a new XmlReader instance by using the specified URI and settings.

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。The URI for the file containing the XML data. XmlReaderSettings オブジェクト上の XmlResolver オブジェクトは、パスを正規データ形式に変換するときに使用されます。The XmlResolver object on the XmlReaderSettings object is used to convert the path to a canonical data representation. XmlResolvernull の場合は、新しい XmlUrlResolver オブジェクトが使用されます。If XmlResolver is null, a new XmlUrlResolver object is used.

settings
XmlReaderSettings

新しい XmlReader インスタンスの設定。The settings for the new XmlReader instance. この値は、null の場合もあります。This value can be null.

戻り値

ストリーム内の XML データの読み取りに使用するオブジェクト。An object that is used to read the XML data in the stream.

例外

inputUri 値は null です。The inputUri value is null.

URI で指定したファイルが見つかりません。The file specified by the URI cannot be found.

Windows ストア アプリ用 .NET またはポータブル クラス ライブラリでは、基本クラスの例外である FormatException を代わりにキャッチします。In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, FormatException, instead.

URI の形式が正しくありません。The URI format is not correct.

次の例ではXmlReader 、ドキュメント型定義 (DTD) 検証をサポートするオブジェクトを作成します。The following example creates an XmlReader object that supports document type definition (DTD) validation.

// 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)、エンティティ、スキーマなどの外部リソースへのアクセスに使用されます。By default an XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

重要

.NET Framework 4.5.2 以降では、既定値XmlUrlResolverは指定されていません。Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. ソリューションが .NET Framework 4.5.2 以降のバージョンを対象としているXmlResolver場合はXmlReaderSettings.XmlResolver 、プロパティを使用してを指定します。If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

これは、 XmlReaderが認証を必要としない任意の場所にアクセスできることを意味します。This means that the XmlReader can access any locations that does not require authentication. 外部リソースが認証を必要とするネットワークリソースに配置されているXmlReaderSettings.XmlResolver場合は、プロパティXmlResolverを使用して、必要な資格情報を持つを指定します。If the external resource is located on a network resource that requires authentication, use the XmlReaderSettings.XmlResolver property to specify an XmlResolver with the necessary credentials.

重要

がアクセスXmlReaderできるリソースを制限するには、 XmlResolverプロパティをXmlSecureResolverオブジェクトに設定します。You can restrict the resources that the XmlReader can access by setting the XmlResolver property to an XmlSecureResolver object.

作成さXmlReaderれたオブジェクトは、エンティティ参照を展開し、改行文字の XML 正規化を実行します。The created XmlReader object expands entity references and performs XML normalization of new line characters.

適用対象