System.Xml.XmlReader.Create 方法 (String, XmlReaderSettings, XmlParserContext)

方法描述

使用指定的 URI、XmlReaderSettings 和 XmlParserContext 对象创建一个新的 XmlReader 实例。

语法定义(C# System.Xml.XmlReader.Create 方法 (String, XmlReaderSettings, XmlParserContext) 的用法)

public static XmlReader Create(
	string inputUri,
	XmlReaderSettings settings,
	XmlParserContext inputContext
)

参数/返回值

参数值/返回值 参数类型/返回类型 参数描述/返回描述
inputUri System-String 包含 XML 数据的文件的 URI。XmlReaderSettings 对象上的 XmlResolver 对象用于将路径转换为规范化数据表示形式。如果 XmlResolver 为 null，则使用新的 XmlUrlResolver 对象。
settings System-Xml-XmlReaderSettings XmlReaderSettings 对象用于配置新的 XmlReader 实例。该值可为 null。
inputContext System-Xml-XmlParserContext XmlParserContext 对象可以提供分析 XML 片段所需的上下文信息。上下文信息可以包括要使用的 XmlNameTable、编码、命名空间范围、当前的 xml:lang 和 xml:space 范围、基 URI 和文档类型定义。此值可为 null。
返回值 System.Xml.XmlReader 用于读取 XML 数据的 XmlReader 对象。

提示和注释

默认情况下，使用没有凭据的 XmlUrlResolver 访问所有外部资源，例如文档类型定义 (DTD)、实体、架构等。 这意味着，XmlReader 可以访问任何不需要身份验证的位置。 如果外部资源所在的网络资源要求身份验证，则使用 XmlReaderSettings.XmlResolver 属性来指定具有必要凭据的 XmlResolver。

安全说明

通过将 XmlResolver 属性设置为 XmlSecureResolver 对象，可以限制 XmlReader 可以访问的资源。

创建的 XmlReader 对象会扩展实体引用并执行新行字符的 XML 规范化。

System.Xml.XmlReader.Create 方法 (String, XmlReaderSettings, XmlParserContext)例子

异常

异常 异常描述
ArgumentNullException inputUri 值为 null。
SecurityException XmlReader 没有访问 XML 数据位置所需的足够权限。
ArgumentException XmlReaderSettings.NameTable 和 XmlParserContext.NameTable 属性都包含值。 （只可以设置并使用这两个 NameTable 属性之中的一个。）
FileNotFoundException 无法找到由该 URI 指定的文件。
UriFormatException URI 格式不正确。

命名空间

namespace: System.Xml

程序集: System.Xml（在 System.Xml.dll 中）

版本信息

.NET Framework 受以下版本支持：4、3.5、3.0、2.0 .NET Framework Client Profile 受以下版本支持：4、3.5 SP1

适用平台

Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008（不支持服务器核心）, Windows Server 2008 R2（支持 SP1 或更高版本的服务器核心）, Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表，请参见.NET Framework 系统要求。

相关资源

XmlReader 类
Create 重载
System.Xml 命名空间
创建 XML 读取器
MSDN