System.Xml.XmlWriter.WriteString 方法
方法描述
当在派生类中被重写时，编写给定的文本内容。
语法定义(C# System.Xml.XmlWriter.WriteString 方法 的用法)
public abstract void WriteString( string text )
参数/返回值
| 参数值/返回值 | 参数类型/返回类型 | 参数描述/返回描述 |
|---|---|---|
| text | System-String | 要编写的文本。 |
| 返回值 | void |
提示和注释
WriteString 执行以下操作：
分别用 &、< 和 > 替换字符 &、< 和 >。
尝试在 0x-0x1F（除了空白字符 0x9、0xA 和 0xD）范围内写入字符值时，使用 Create 创建的 XmlWriter 的默认行为会引发 ArgumentException。 通过创建其 CheckCharacters 属性设置为 false 的 XmlWriter，可写入这些无效的 XML 字符。 这样做将导致这些字符被替换为数字字符实体 (� through �x1F)。 另外，使用 new 运算符创建的 XmlTextWriter 默认情况下还会使用数字字符实体替换无效的字符。
注意：Microsoft 建议您不要写入无效的 XML 字符，因为使用 XML 的很多应用程序不能处理无效字符。
如果在特性值的上下文中调用 WriteString，则分别用 " 和 ' 替换双引号和单引号。
例如，输入字符串 test
复制
test<item>test
如果 text 为 null 或 String.Empty，则此方法编写没有数据内容的文本节点。
System.Xml.XmlWriter.WriteString 方法例子
下面的示例编写一个 XML 节点。
using System;
using System.IO;
using System.Xml;
public class Sample {
public static void Main() {
// Create a writer to write XML to the console.
XmlWriterSettings settings = new XmlWriterSettings();
settings.Indent = true;
settings.OmitXmlDeclaration = true;
XmlWriter writer = XmlWriter.Create(Console.Out, settings);
// Write the book element.
writer.WriteStartElement("book");
// Write the title element.
writer.WriteStartElement("title");
writer.WriteString("Pride And Prejudice");
writer.WriteEndElement();
// Write the close tag for the root element.
writer.WriteEndElement();
// Write the XML and close the writer.
writer.Close();
}
}
异常
| 异常 | 异常描述 |
|---|---|
| ArgumentException | 文本字符串包含无效的代理项对。 |
版本信息
.NET Framework 受以下版本支持：4、3.5、3.0、2.0、1.1、1.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 系统要求。