public ref class XmlWriterSettings sealed
public sealed class XmlWriterSettings
type XmlWriterSettings = class
Public NotInheritable Class XmlWriterSettings
XmlWriterSettings
以下示例创建一个
XmlWriter
,用于写入 XML 文件,并在新行上写入每个属性。
XmlWriterSettings settings = new XmlWriterSettings();
settings.Indent = true;
settings.OmitXmlDeclaration = true;
settings.NewLineOnAttributes = true;
writer = XmlWriter.Create(Console.Out, settings);
writer.WriteStartElement("order");
writer.WriteAttributeString("orderID", "367A54");
writer.WriteAttributeString("date", "2001-05-03");
writer.WriteElementString("price", "19.95");
writer.WriteEndElement();
writer.Flush();
Dim settings As New XmlWriterSettings()
settings.Indent = True
settings.OmitXmlDeclaration = True
settings.NewLineOnAttributes = True
writer = XmlWriter.Create(Console.Out, settings)
writer.WriteStartElement("order")
writer.WriteAttributeString("orderID", "367A54")
writer.WriteAttributeString("date", "2001-05-03")
writer.WriteElementString("price", "19.95")
writer.WriteEndElement()
writer.Flush()
此示例生成以下输出:
<order
orderID="367A54"
date="2001-05-03">
<price>19.95</price>
</order>
方法 Create 是获取 XmlWriter 实例的首选机制。 方法 Create 使用 XmlWriterSettings 类指定要在创建的对象中 XmlWriter 实现哪些功能。
如果将 对象与 方法一起使用XmlWriterTransform,则应使用 OutputSettings 属性获取XmlWriterSettings具有正确设置的对象。 这样可以确保所创建的 XmlWriter 对象的输出设置是正确的。
类 XmlWriterSettings 提供用于控制数据一致性和输出格式的属性。
对于数据一致性检查和自动更正,请使用以下属性:
properties
ConformanceLevel
检查输出是否为格式正确的 XML 1.0 文档或片段。
ConformanceLevel.Document (文档级) 、 Fragment (片段级) 或 Auto (自动检测)
ConformanceLevel.Document (文档级一致性)
WriteEndDocumentOnClose
调用 方法时 Close ,是否向所有未关闭的元素添加结束标记。
true
或 false
若要指定输出格式,请使用以下属性:
properties
NewLineHandling
如何处理换行符。
System.Xml.NewLineHandling value: Entitize (规范化) 、 Replace (替换) 或 None (保持不变)
Replace (替换为) 指定的 NewLineChars 字符
NewLineOnAttributes
当) 时 Indentfalse
,是否在单个行上写入属性 (不起作用。
true
或 false
false
OmitXmlDeclaration
是否编写 XML 声明。
true
或 false
false