System.Xml.XmlReader.Create 方法 (Stream)

方法描述

使用指定的流创建一个新的 XmlReader 实例。

语法定义(C# System.Xml.XmlReader.Create 方法 (Stream) 的用法)

public static XmlReader Create(
	Stream input
)

参数/返回值

参数值/返回值 参数类型/返回类型 参数描述/返回描述
input System-IO-Stream 包含 XML 数据的流。XmlReader 对流的前几个字节进行扫描，查找字节顺序标记或其他编码标志。在确定编码方式后，使用该编码方式继续读取流，而处理过程继续将输入内容分析为 (Unicode) 字符流。
返回值 System.Xml.XmlReader 一个用于读取数据流中所含数据的 XmlReader 对象。

提示和注释

使用具有默认设置的 XmlReaderSettings 对象创建读取器。 如果您希望指定一些在已创建的读取器上支持的功能，请使用重载并传入设置正确的 XmlReaderSettings 对象，该重载将 XmlReaderSettings 对象作为自己的一个参数。

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

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

System.Xml.XmlReader.Create 方法 (Stream)例子

下面的示例创建一个从 FileStream 中读取的 XmlReader 对象。

FileStream fs = new FileStream(@"C:\data\books.xml", FileMode.OpenOrCreate, 
                                                                    FileAccess.Read, FileShare.Read);

// Create the XmlReader object.
XmlReader reader = XmlReader.Create(fs);

异常

异常 异常描述
ArgumentNullException input 值为 null。
SecurityException XmlReader 没有访问 XML 数据位置所需的足够权限。

命名空间

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