System.Xml.XmlAttributeCollection.InsertBefore 方法

方法描述

将指定特性直接插入到指定引用特性之前。

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

public XmlAttribute InsertBefore(
	XmlAttribute newNode,
	XmlAttribute refNode
)

参数/返回值

参数值/返回值 参数类型/返回类型 参数描述/返回描述
newNode System-Xml-XmlAttribute 要插入的 XmlAttribute。
refNode System-Xml-XmlAttribute XmlAttribute ，它是引用特性。newNode 放置在 refNode 之前。
返回值 System.Xml.XmlAttribute 要插入到集合中的 XmlAttribute。

提示和注释

如果集合中已存在具有相同名称的特性，则将从集合中移除原始特性，并将 newNode 插入到集合中。 如果 refNode 是 null，则将 newNode 插入到集合的结尾。

该方法是文档对象模型 (DOM) 的 Microsoft 扩展。

System.Xml.XmlAttributeCollection.InsertBefore 方法例子

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

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.InsertBefore(newAttr, attrColl[0]);

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

异常

异常 异常描述
ArgumentException newNode 是从创建此集合的文档之外的另一个文档创建的。 或者，refNode 不是此集合的成员。

命名空间

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