System.Xml.XmlDataDocument 类

上一篇：System.Xml.XmlConvert.VerifyXmlChars 方法下一篇：System.Xml.XmlDataDocument.CloneNode 方法

方法描述

允许通过相关的 DataSet 存储、检索和操作结构化数据。

语法定义(C# System.Xml.XmlDataDocument 类的用法)

[ObsoleteAttribute("XmlDataDocument class will be removed in a future release.")]
[HostProtectionAttribute(SecurityAction.LinkDemand, Synchronization = true)]
public class XmlDataDocument : XmlDocument

构造函数

构造函数名称	构造函数描述
XmlDataDocument()	初始化 XmlDataDocument 类的新实例。
XmlDataDocument(DataSet)	用指定的 DataSet 初始化 XmlDataDocument 类的新实例。

成员/方法

方法名称	方法描述
AppendChild	将指定的节点添加到该节点的子节点列表的末尾。（继承自 XmlNode。）
Clone	创建此节点的一个副本。（继承自 XmlNode。）
CloneNode	创建当前节点的副本。（重写 XmlDocument.CloneNode(Boolean)。）
CreateAttribute(String)	创建具有指定 Name 的 XmlAttribute。（继承自 XmlDocument。）
CreateAttribute(String, String)	创建具有指定限定名和 NamespaceURI 的 XmlAttribute。（继承自 XmlDocument。）
CreateAttribute(String, String, String)	创建一个具有指定的 Prefix、LocalName 和 NamespaceURI 的 XmlAttribute。（继承自 XmlDocument。）
CreateCDataSection	创建包含指定数据的 XmlCDataSection。（继承自 XmlDocument。）
CreateComment	创建包含指定数据的 XmlComment。（继承自 XmlDocument。）
CreateDefaultAttribute	创建具有指定前缀、本地名称和命名空间 URI 的默认特性。（继承自 XmlDocument。）
CreateDocumentFragment	创建 XmlDocumentFragment。（继承自 XmlDocument。）
CreateDocumentType	返回新的 XmlDocumentType 对象。（继承自 XmlDocument。）
CreateElement(String)	创建具有指定名称的元素。（继承自 XmlDocument。）
CreateElement(String, String)	创建具有限定名和 NamespaceURI 的 XmlElement。（继承自 XmlDocument。）
CreateElement(String, String, String)	创建具有指定 Prefix、LocalName 和 NamespaceURI 的元素。（重写 XmlDocument.CreateElement(String, String, String)。）
CreateEntityReference	创建具有指定名称的 XmlEntityReference。不能为 XmlDataDocument 对象创建 XmlEntityReference 节点。调用此方法将引发异常。（重写 XmlDocument.CreateEntityReference(String)。）
CreateNavigator()	创建一个用于导航此文档的新 XPathNavigator 对象。（继承自 XmlDocument。）
CreateNavigator(XmlNode)	创建一个用于导航此文档的新 XPathNavigator 对象。 XPathNavigator 定位在 node 参数中指定的节点上。（重写 XmlDocument.CreateNavigator(XmlNode)。）
CreateNode(String, String, String)	创建具有指定的节点类型、Name 和 NamespaceURI 的 XmlNode。（继承自 XmlDocument。）
CreateNode(XmlNodeType, String, String)	创建一个具有指定的 XmlNodeType、Name 和 NamespaceURI 的 XmlNode。（继承自 XmlDocument。）
CreateNode(XmlNodeType, String, String, String)	创建一个具有指定的 XmlNodeType、Prefix、Name 和 NamespaceURI 的 XmlNode。（继承自 XmlDocument。）
CreateProcessingInstruction	创建一个具有指定名称和数据的 XmlProcessingInstruction。（继承自 XmlDocument。）
CreateSignificantWhitespace	创建一个 XmlSignificantWhitespace 节点。（继承自 XmlDocument。）
CreateTextNode	创建具有指定文本的 XmlText。（继承自 XmlDocument。）
CreateWhitespace	创建一个 XmlWhitespace 节点。（继承自 XmlDocument。）
CreateXmlDeclaration	创建一个具有指定值的 XmlDeclaration 节点。（继承自 XmlDocument。）
Equals(Object)	确定指定的 Object 是否等于当前的 Object。（继承自 Object。）
Finalize	允许对象在“垃圾回收”回收之前尝试释放资源并执行其他清理操作。（继承自 Object。）
GetElementById	获取具有指定 ID 的 XmlElement。 XmlDataDocument 类不支持该方法。调用此方法将引发异常。（重写 XmlDocument.GetElementById(String)。）
GetElementFromRow	检索与指定 DataRow 关联的 XmlElement。
GetElementsByTagName(String)	返回一个 XmlNodeList，它包含与指定 Name 匹配的所有子代元素的列表。（重写 XmlDocument.GetElementsByTagName(String)。）
GetElementsByTagName(String, String)	返回一个 XmlNodeList，它包含与指定 LocalName 和 NamespaceURI 匹配的所有子代元素的列表。（继承自 XmlDocument。）
GetEnumerator	提供对 XmlNode 中节点上“for each”样式迭代的支持。（继承自 XmlNode。）
GetHashCode	用作特定类型的哈希函数。（继承自 Object。）
GetNamespaceOfPrefix	查找当前节点范围内离给定的前缀最近的 xmlns 声明，并返回声明中的命名空间 URI。（继承自 XmlNode。）
GetPrefixOfNamespace	查找当前节点范围内离给定的命名空间 URI 最近的 xmlns 声明，并返回声明中定义的前缀。（继承自 XmlNode。）
GetRowFromElement	检索与指定 XmlElement 关联的 DataRow。
GetType	获取当前实例的 Type。（继承自 Object。）
ImportNode	将节点从另一个文档导入到当前文档。（继承自 XmlDocument。）
InsertAfter	将指定的节点紧接着插入指定的引用节点之后。（继承自 XmlNode。）
InsertBefore	将指定的节点紧接着插入指定的引用节点之前。（继承自 XmlNode。）
Load(Stream)	从指定的流加载 XmlDataDocument。（重写 XmlDocument.Load(Stream)。）
Load(String)	使用指定的 URL 加载 XmlDataDocument。（重写 XmlDocument.Load(String)。）
Load(TextReader)	从指定的 TextReader 加载 XmlDataDocument。（重写 XmlDocument.Load(TextReader)。）
Load(XmlReader)	从指定的 XmlReader 加载 XmlDataDocument。（重写 XmlDocument.Load(XmlReader)。）
LoadXml	从指定的字符串加载 XML 文档。（继承自 XmlDocument。）
MemberwiseClone	创建当前 Object 的浅表副本。（继承自 Object。）
Normalize	将此 XmlNode 下子树完全深度中的所有 XmlText 节点都转换成“正常”形式，在这种形式中只有标记（即标记、注释、处理指令、CDATA 节和实体引用）分隔 XmlText 节点，也就是说，没有相邻的 XmlText 节点。（继承自 XmlNode。）
PrependChild	将指定的节点添加到该节点的子节点列表的开头。（继承自 XmlNode。）
ReadNode	根据 XmlReader 中的信息创建一个 XmlNode 对象。读取器必须定位在节点或特性上。（继承自 XmlDocument。）
RemoveAll	移除当前节点的所有子节点和/或特性。（继承自 XmlNode。）
RemoveChild	移除指定的子节点。（继承自 XmlNode。）
ReplaceChild	用 newChild 节点替换子节点 oldChild。（继承自 XmlNode。）
Save(Stream)	将 XML 文档保存到指定的流。（继承自 XmlDocument。）
Save(String)	将 XML 文档保存到指定的文件。（继承自 XmlDocument。）
Save(TextWriter)	将 XML 文档保存到指定的 TextWriter。（继承自 XmlDocument。）
Save(XmlWriter)	将 XML 文档保存到指定的 XmlWriter。（继承自 XmlDocument。）
SelectNodes(String)	选择匹配 XPath 表达式的节点列表。（继承自 XmlNode。）
SelectNodes(String, XmlNamespaceManager)	选择匹配 XPath 表达式的节点列表。 XPath 表达式中的任何前缀都使用提供的 XmlNamespaceManager 进行解析。（继承自 XmlNode。）
SelectSingleNode(String)	选择匹配 XPath 表达式的第一个 XmlNode。（继承自 XmlNode。）
SelectSingleNode(String, XmlNamespaceManager)	选择匹配 XPath 表达式的第一个 XmlNode。 XPath 表达式中的任何前缀都使用提供的 XmlNamespaceManager 进行解析。（继承自 XmlNode。）
Supports	测试 DOM 实现是否实现特定的功能。（继承自 XmlNode。）
ToString	返回表示当前对象的字符串。（继承自 Object。）
Validate(ValidationEventHandler)	验证 XmlDocument 是不是 Schemas 属性中包含的 XML 架构定义语言 (XSD) 架构。（继承自 XmlDocument。）
Validate(ValidationEventHandler, XmlNode)	根据 Schemas 属性中的 XML 架构定义语言 (XSD) 架构，验证指定的 XmlNode 对象。（继承自 XmlDocument。）
WriteContentTo	将 XmlDocument 节点的所有子级保存到指定的 XmlWriter 中。（继承自 XmlDocument。）
WriteTo	将 XmlDocument 节点保存到指定的 XmlWriter。（继承自 XmlDocument。）

提示和注释

此类扩展了 XmlDocument。它使您可以加载关系数据或 XML 数据，并可使用 WWW 联合会 (W3C) 文档对象模型 (DOM) 操作这些数据。 DOM 将数据显示为节点对象层次结构。由于 XmlDataDocument 实现 IXPathNavigable 接口，因此它还可用作 XslTransform 类的源文档。

XmlDataDocument 与 DataSet 类有密切的从属关系，后者提供所加载的 XML 数据的关系视图。对 XmlDataDocument 所做的任何更改都将反映在 DataSet 中，反之亦然。

若要将 XML 数据加载到 DataSet 中，请使用 ReadXmlSchema 生成关系映射。然后，可以使用 Load 或 LoadXml 加载 XML 数据。

若要加载关系数据，请将包含关系数据的 DataSet 指定为 XmlDataDocument 构造函数中的参数。

注意

应用到此类型或成员的 HostProtectionAttribute 特性具有以下 Resources 属性值：Synchronization。HostProtectionAttribute 不影响桌面应用程序（桌面应用程序一般通过双击图标、键入命令或在浏览器中输入 URL 启动）。有关更多信息，请参见 HostProtectionAttribute 类或 SQL Server 编程和宿主保护特性。