XmlReader.Create メソッド

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

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

パラメーター

戻り値

ストリーム内の XML データの読み取りに使用するオブジェクト。

例外

注釈

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

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

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

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

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

パラメーター

戻り値

ストリーム内の XML データの読み取りに使用するオブジェクト。

例外

例

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

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

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

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

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

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

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

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

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

注釈

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

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

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

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

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

パラメーター

戻り値

ストリーム内の XML データの読み取りに使用するオブジェクト。

例外

注釈

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

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

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

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

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

パラメーター

戻り値

ストリーム内の XML データの読み取りに使用するオブジェクト。

例外

注釈

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

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

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

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

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

パラメーター

戻り値

指定された XmlReader オブジェクトをラップするオブジェクト。

例外

例

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

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

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

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

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

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

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

注釈

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

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

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

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

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

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

パラメーター

戻り値

ストリーム内の XML データの読み取りに使用するオブジェクト。

例外

注釈

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

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

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

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

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

パラメーター

戻り値

ストリーム内の XML データの読み取りに使用するオブジェクト。

例外

注釈

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

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

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

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

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

パラメーター

戻り値

ストリーム内の XML データの読み取りに使用するオブジェクト。

例外

注釈

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

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

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

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

パラメーター

戻り値

ストリーム内の XML データの読み取りに使用するオブジェクト。

例外

例

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

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

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

注釈

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

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

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

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

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

パラメーター

戻り値

ストリーム内の XML データの読み取りに使用するオブジェクト。

例外

例

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

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

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

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

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

注釈

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

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

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

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

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

パラメーター

戻り値

ストリーム内の XML データの読み取りに使用するオブジェクト。

例外

例

次の例では、 からを XmlReader 読み取る オブジェクトを 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

注釈

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

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

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

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

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

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

パラメーター

戻り値

ストリーム内の XML データの読み取りに使用するオブジェクト。

例外

例

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

// 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)、エンティティ、スキーマなどの外部リソースにアクセスするために使用されます。

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

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