XmlReader.Create XmlReader.Create XmlReader.Create XmlReader.Create Method

定義

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

オーバーロード

Create(String, XmlReaderSettings, XmlParserContext) Create(String, XmlReaderSettings, XmlParserContext) Create(String, XmlReaderSettings, XmlParserContext) 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) Create(TextReader, XmlReaderSettings, XmlParserContext) Create(TextReader, XmlReaderSettings, XmlParserContext) 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) Create(Stream, XmlReaderSettings, XmlParserContext) Create(Stream, XmlReaderSettings, XmlParserContext) Create(Stream, XmlReaderSettings, XmlParserContext)

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

Create(Stream, XmlReaderSettings, String) Create(Stream, XmlReaderSettings, String) Create(Stream, XmlReaderSettings, String) Create(Stream, XmlReaderSettings, String)

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

Create(XmlReader, XmlReaderSettings) Create(XmlReader, XmlReaderSettings) Create(XmlReader, XmlReaderSettings) Create(XmlReader, XmlReaderSettings)

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

Create(TextReader, XmlReaderSettings, String) Create(TextReader, XmlReaderSettings, String) Create(TextReader, XmlReaderSettings, String) Create(TextReader, XmlReaderSettings, String)

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

Create(TextReader, XmlReaderSettings) Create(TextReader, XmlReaderSettings) Create(TextReader, XmlReaderSettings) Create(TextReader, XmlReaderSettings)

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

Create(Stream, XmlReaderSettings) Create(Stream, XmlReaderSettings) Create(Stream, XmlReaderSettings) Create(Stream, XmlReaderSettings)

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

Create(String) Create(String) Create(String) Create(String)

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

Create(TextReader) Create(TextReader) Create(TextReader) Create(TextReader)

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

Create(Stream) Create(Stream) Create(Stream) Create(Stream)

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

Create(String, XmlReaderSettings) Create(String, XmlReaderSettings) Create(String, XmlReaderSettings) 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.

  • 優れた一致チェックへの準拠などの機能の活用、 XML 1.0 (fourth edition)でのみ使用可能な推奨事項XmlReader静的によって作成されたオブジェクト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.

注意

.NET Framework の具象実装が含まれますが、XmlReaderクラスなど、 XmlTextReaderXmlNodeReader、およびXmlValidatingReader作成することを推奨しましたクラス、XmlReaderインスタンスを使用して、 Createメソッド。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 ProcessIdentityConstraints 有効になっています。ProcessIdentityConstraints 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

ここでは、XmlReaderSettingsプロパティの XML リーダーの一般的なシナリオのいくつか設定する必要があります。Here 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. ConformanceLevel Documentします。ConformanceLevel to Document.
データは整形式 XML の解析対象エンティティである必要があります。Data must be a well-formed XML parsed entity. ConformanceLevel Fragmentします。ConformanceLevel to Fragment.
データは、DTD に対して検証する必要があります。Data must be validated against a DTD. DtdProcessingParseDtdProcessing to Parse
ValidationType DTDします。ValidationType to DTD.
データは、XML スキーマに対して検証する必要があります。Data must be validated against an XML schema. ValidationTypeSchemaValidationType to Schema
Schemas XmlSchemaSet検証に使用します。Schemas to the XmlSchemaSet to use for validation. なおXmlReaderXml-data Reduced (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
ValidationFlags ProcessInlineSchemaします。ValidationFlags to ProcessInlineSchema.
サポートを入力します。Type support. ValidationTypeSchemaValidationType to Schema
Schemas XmlSchemaSetを使用します。Schemas to the XmlSchemaSet to use.

XmlReader Xml-data Reduced (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-

  • 設定XmlResolvernullXML リーダーが外部リソースを開くことを防ぐためにします。Set XmlResolver to null to prevent the XML reader from opening any external resources.

Create(String, XmlReaderSettings, XmlParserContext) Create(String, XmlReaderSettings, XmlParserContext) Create(String, XmlReaderSettings, XmlParserContext) 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 String String 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 XmlReaderSettings XmlReaderSettings XmlReaderSettings

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

inputContext
XmlParserContext XmlParserContext XmlParserContext 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) Create(TextReader, XmlReaderSettings, XmlParserContext) Create(TextReader, XmlReaderSettings, XmlParserContext) 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 TextReader TextReader 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 XmlReaderSettings XmlReaderSettings XmlReaderSettings

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

inputContext
XmlParserContext XmlParserContext XmlParserContext 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) Create(Stream, XmlReaderSettings, XmlParserContext) Create(Stream, XmlReaderSettings, XmlParserContext) 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 Stream Stream 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 XmlReaderSettings XmlReaderSettings XmlReaderSettings

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

inputContext
XmlParserContext XmlParserContext XmlParserContext 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) Create(Stream, XmlReaderSettings, String) Create(Stream, XmlReaderSettings, String) 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 Stream Stream 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 XmlReaderSettings XmlReaderSettings XmlReaderSettings

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

baseUri
String String String 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) Create(XmlReader, XmlReaderSettings) Create(XmlReader, XmlReaderSettings) 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 XmlReader XmlReader XmlReader

基になる XML リーダーとして使用するオブジェクト。The object that you want to use as the underlying XML reader.

settings
XmlReaderSettings XmlReaderSettings XmlReaderSettings 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実装します。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) Create(TextReader, XmlReaderSettings, String) Create(TextReader, XmlReaderSettings, String) 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 TextReader TextReader 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 XmlReaderSettings XmlReaderSettings XmlReaderSettings

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

baseUri
String String String 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) Create(TextReader, XmlReaderSettings) Create(TextReader, XmlReaderSettings) 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 TextReader TextReader 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 XmlReaderSettings XmlReaderSettings 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) Create(Stream, XmlReaderSettings) Create(Stream, XmlReaderSettings) 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 Stream Stream 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 XmlReaderSettings XmlReaderSettings 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) Create(String) Create(String) 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 String String 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")

注釈

XmlReaderSettings既定の設定を持つオブジェクトは、リーダーの作成に使用します。An 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) Create(TextReader) Create(TextReader) 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 TextReader TextReader 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))

注釈

XmlReaderSettings既定の設定を持つオブジェクトは、リーダーの作成に使用します。An 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) Create(Stream) Create(Stream) 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 Stream Stream 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.

次の例では、作成、XmlReaderオブジェクトから読み取る、FileStreamします。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 'FileStream

注釈

XmlReaderSettings既定の設定を持つオブジェクトは、リーダーの作成に使用します。An 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) Create(String, XmlReaderSettings) Create(String, XmlReaderSettings) 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 String String 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 XmlReaderSettings XmlReaderSettings 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.

適用対象