System.Xml.XmlWriter.Create 方法 (Stream, XmlWriterSettings)

方法描述

使用流和 XmlWriterSettings 对象创建一个新的 XmlWriter 实例。

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

public static XmlWriter Create(
	Stream output,
	XmlWriterSettings settings
)

参数/返回值

参数值/返回值 参数类型/返回类型 参数描述/返回描述
output System-IO-Stream 要写入的流。XmlWriter 编写 XML 1.0 文本语法并将其追加到指定的流。
settings System-Xml-XmlWriterSettings 用于配置新的 XmlWriter 实例的 XmlWriterSettings 对象。如果这是 null,则使用具有默认设置的 XmlWriterSettings。如果将 XmlWriter 用于 Transform 方法,则应使用 OutputSettings 属性获取具有正确设置的 XmlWriterSettings 对象。这样可以确保所创建的 XmlWriter 对象的输出设置是正确的。
返回值 System.Xml.XmlWriter 一个 XmlWriter 对象。

提示和注释

System.Xml.XmlWriter.Create 方法 (Stream, XmlWriterSettings)例子

下面的示例将 XML 片段写入内存流。

XmlWriterSettings settings = new XmlWriterSettings();
settings.OmitXmlDeclaration = true;
settings.ConformanceLevel = ConformanceLevel.Fragment;
settings.CloseOutput = false;

// Create the XmlWriter object and write some content.
MemoryStream strm = new MemoryStream();
XmlWriter writer = XmlWriter.Create(strm, settings);
writer.WriteElementString("orderID", "1-456-ab");
writer.WriteElementString("orderID", "2-36-00a");
writer.Flush();
writer.Close();

// Do additonal processing on the stream.

异常

异常 异常描述
ArgumentNullException stream 值为 null。

命名空间

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 系统要求。