System.Xml.XmlAttributeCollection.SetNamedItem 方法

方法描述

使用 Name 属性添加 XmlNode

语法定义(C# System.Xml.XmlAttributeCollection.SetNamedItem 方法 的用法)

public override XmlNode SetNamedItem(
	XmlNode node
)

参数/返回值

参数值/返回值 参数类型/返回类型 参数描述/返回描述
node System-Xml-XmlNode 要存储在此集合中的特性节点。以后可以使用节点的名称访问该节点。如果集合中已存在具有该名称的节点，则用新的进行替换；否则，将把该节点追加到集合的末尾。
返回值 System.Xml.XmlNode 如果 node 替换具有相同名称的现有节点，则返回旧节点；否则返回新添加的节点。

提示和注释

System.Xml.XmlAttributeCollection.SetNamedItem 方法例子

下面的示例向文档中添加一个新特性。

using System;
using System.IO;
using System.Xml;

public class Sample
{
  public static void Main(){

    XmlDocument doc = new XmlDocument();
    doc.LoadXml("" +
                "Pride And Prejudice" +
                "");      

    //Create a new attribute.
    XmlAttribute newAttr = doc.CreateAttribute("genre");
    newAttr.Value = "novel";

    //Create an attribute collection and add the new attribute
    //to the collection.
    XmlAttributeCollection attrColl = doc.DocumentElement.Attributes;
    attrColl.SetNamedItem(newAttr);

    Console.WriteLine("Display the modified XML...\r\n");
    Console.WriteLine(doc.OuterXml);  
  }
}

异常

异常 异常描述
ArgumentException node 是从创建此集合的文档之外的另一个 XmlDocument 创建的。 此 XmlAttributeCollection 为只读。
InvalidOperationException node 是 XmlAttribute，后者已经是另一个 XmlElement 对象的特性。 若要在其他元素中重新使用特性，必须克隆想重新使用的 XmlAttribute 对象。

命名空间

namespace: System.Xml

程序集: System.Xml（在 System.Xml.dll 中）

版本信息

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

相关资源

XmlAttributeCollection 类
System.Xml 命名空间
MSDN