System.Xml.XmlElement.SetAttribute 方法 (String, String)

方法描述

设置具有指定名称的特性的值。

语法定义(C# System.Xml.XmlElement.SetAttribute 方法 (String, String) 的用法)

public virtual void SetAttribute(
	string name,
	string value
)

参数/返回值

参数值/返回值 参数类型/返回类型 参数描述/返回描述
name System-String 要创建或更改的特性的名称。这是限定名。如果该名称包含一个冒号,则将其解析为前缀和本地名称两个部分。
value System-String 要为此特性设置的值。
返回值 void

提示和注释

如果具有相同名称的特性已存在于该元素中,则其值更改为 value 的值。 value 是一个简单字符串。 当设置它时不对其进行分析。 任何标记(例如将被识别为实体引用的语法)都被当做文本对待,当将其写出时,需要由实现对其进行正确地转义。 为了分配一个包含实体引用的特性值,用户必须创建 XmlAttribute 节点以及任何 XmlText 和 XmlEntityReference 节点,生成适当的子树并使用 SetAttributeNode 将其作为特性的值分配。

System.Xml.XmlElement.SetAttribute 方法 (String, String)例子

下面的示例向元素添加特性。


异常

异常 异常描述
XmlException 指定的名称包含无效字符。
ArgumentException 节点是只读的。

命名空间

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