XmlReader.Create 方法

使用指定的 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

参数

返回

异常

注解

默认情况下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.

使用指定的文本读取器、设置和要用于分析的上下文信息创建一个新的 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

参数

返回

异常

示例

下面的示例创建一个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.

如果外部资源位于要求身份验证的网络资源上，请使用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.

使用指定的流、设置和用于分析的上下文信息创建一个新的 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

参数

返回

异常

注解

默认情况下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.

使用指定的流、基 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

参数

返回

异常

注解

默认情况下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.

使用指定的 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

参数

返回

异常

示例

下面的示例创建一个在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.

如果外部资源位于要求身份验证的网络资源上，则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.

使用指定的文本读取器、设置和基 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

参数

返回

异常

注解

默认情况下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.

使用指定的文本读取器和设置创建一个新的 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

参数

返回

异常

注解

默认情况下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.

使用指定的流和设置创建一个新的 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

参数

返回

异常

注解

默认情况下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.

用指定的 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

参数

返回

异常

示例

下面的示例创建一个XmlReader对象，该对象读取 URI 指定的 XML 数据文件。The following example creates an XmlReader object that reads XML data file specified by the URI.

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

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

注解

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

如果外部资源位于要求身份验证的网络资源上，则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.

使用指定的文本读取器创建一个新的 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

参数

返回

异常

示例

下面的示例使用StringReader类读取 XML 字符串。The following example uses the StringReader class to read an XML string.

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

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

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

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

注解

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

如果外部资源位于要求身份验证的网络资源上，则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.

使用带默认设置的指定流创建新的 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

参数

返回

异常

示例

下面的示例创建一个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

注解

使用具有默认设置的对象来创建读取器。XmlReaderSettingsAn 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.

如果外部资源位于要求身份验证的网络资源上，则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.

使用指定的 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

参数

返回

异常

示例

下面的示例创建一个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.

这意味着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.