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

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

参数

返回

例外

注解

默认情况下，不带凭据的 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.

这意味着 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 对象扩展实体引用并执行新行字符的 XML 规范化。The created XmlReader object expands entity references and performs XML normalization of new line characters.

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 片段的 XmlReader 对象。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.

如果外部资源位于要求身份验证的网络资源上，请使用 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 对象扩展实体引用并执行新行字符的 XML 规范化。The created XmlReader object expands entity references and performs XML normalization of new line characters.

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

参数

返回

例外

注解

默认情况下，不带凭据的 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.

如果外部资源位于要求身份验证的网络资源上，请使用 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 对象扩展实体引用并执行新行字符的 XML 规范化。The created XmlReader object expands entity references and performs XML normalization of new line characters.

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

参数

返回

例外

注解

默认情况下，不带凭据的 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.

如果外部资源位于要求身份验证的网络资源上，请使用 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 对象扩展实体引用并执行新行字符的 XML 规范化。The created XmlReader object expands entity references and performs XML normalization of new line characters.

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 对象，该对象围绕 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 对象可以是 Create 方法创建的另一个 XmlReader 对象，也可以是使用一个具体 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.

如果外部资源位于要求身份验证的网络资源上，则使用 XmlReaderSettings.XmlResolver 属性指定具有所需凭据的 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.

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

参数

返回

例外

注解

默认情况下，不带凭据的 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.

如果外部资源位于要求身份验证的网络资源上，请使用 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 对象扩展实体引用并执行新行字符的 XML 规范化。The created XmlReader object expands entity references and performs XML normalization of new line characters.

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

参数

返回

例外

注解

默认情况下，不带凭据的 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.

如果外部资源位于要求身份验证的网络资源上，请使用 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 对象扩展实体引用并执行新行字符的 XML 规范化。The created XmlReader object expands entity references and performs XML normalization of new line characters.

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

参数

返回

例外

注解

默认情况下，不带凭据的 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.

如果外部资源位于要求身份验证的网络资源上，请使用 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 对象扩展实体引用并执行新行字符的 XML 规范化。The created XmlReader object expands entity references and performs XML normalization of new line characters.

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

参数

返回

例外

示例

下面的示例创建一个读取 URI 指定的 XML 数据文件的 XmlReader 对象。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 对象作为其参数之一的重载，并传入具有正确设置的 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.

如果外部资源位于要求身份验证的网络资源上，则使用 XmlReaderSettings.XmlResolver 属性指定具有所需凭据的 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.

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

参数

返回

例外

示例

下面的示例使用 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 对象作为其参数之一的重载，并传入具有正确设置的 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.

如果外部资源位于要求身份验证的网络资源上，则使用 XmlReaderSettings.XmlResolver 属性指定具有所需凭据的 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.

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

参数

返回

例外

示例

下面的示例创建一个从 FileStream读取的 XmlReader 对象。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

注解

使用默认设置的 XmlReaderSettings 对象用于创建读取器。An XmlReaderSettings object with default settings is used to create the reader. 如果希望在创建的读取器上指定支持的功能，请使用将 XmlReaderSettings 对象作为其参数之一的重载，并传入具有正确设置的 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.

如果外部资源位于要求身份验证的网络资源上，则使用 XmlReaderSettings.XmlResolver 属性指定具有所需凭据的 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.

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

参数

返回

例外

示例

下面的示例创建支持文档类型定义（DTD）验证的 XmlReader 对象。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.

这意味着 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 对象扩展实体引用并执行新行字符的 XML 规范化。The created XmlReader object expands entity references and performs XML normalization of new line characters.