XmlElement.SetAttribute 方法

定义

设置所指定特性的值。Sets the value of the specified attribute.

重载

SetAttribute(String, String)

设置具有指定名称的特性的值。Sets the value of the attribute with the specified name.

SetAttribute(String, String, String)

设置具有指定本地名称和命名空间 URI 的特性的值。Sets the value of the attribute with the specified local name and namespace URI.

SetAttribute(String, String)

设置具有指定名称的特性的值。Sets the value of the attribute with the specified name.

public:
 virtual void SetAttribute(System::String ^ name, System::String ^ value);
public virtual void SetAttribute (string name, string value);
public virtual void SetAttribute (string name, string? value);
abstract member SetAttribute : string * string -> unit
override this.SetAttribute : string * string -> unit
Public Overridable Sub SetAttribute (name As String, value As String)

参数

name
String

要创建或更改的特性的名称。The name of the attribute to create or alter. 这是限定名。This is a qualified name. 如果该名称包含一个冒号,则将其解析为前缀和本地名称两个部分。If the name contains a colon it is parsed into prefix and local name components.

value
String

要为此特性设置的值。The value to set for the attribute.

例外

指定的名称包含无效字符。The specified name contains an invalid character.

该节点是只读的。The node is read-only.

注解

如果元素中已经存在具有相同名称的属性,则其值将更改为的 valueIf an attribute with the same name is already present in the element, its value is changed to that of value. value 是一个简单字符串。value is a simple string. 在设置时,不会对其进行分析。It is not parsed as it is being set. 任何标记(如识别为实体引用的语法)被视为文本文本,并在写出时需要由实现进行正确转义。若要分配包含实体引用的属性值,用户必须创建一个 XmlAttribute 节点以及所有 XmlTextXmlEntityReference 节点,生成适当的子树,并使用将 SetAttributeNode 其分配为属性的值。Any markup, such as syntax to be recognized as an entity reference, is treated as literal text and needs to be properly escaped by the implementation when it is written out. In order to assign an attribute value that contains entity references, the user must create an XmlAttribute node plus any XmlText and XmlEntityReference nodes, build the appropriate subtree and use SetAttributeNode to assign it as the value of an attribute.

适用于

SetAttribute(String, String, String)

设置具有指定本地名称和命名空间 URI 的特性的值。Sets the value of the attribute with the specified local name and namespace URI.

public:
 virtual System::String ^ SetAttribute(System::String ^ localName, System::String ^ namespaceURI, System::String ^ value);
public virtual string SetAttribute (string localName, string namespaceURI, string value);
public virtual string SetAttribute (string? localName, string namespaceURI, string value);
abstract member SetAttribute : string * string * string -> string
override this.SetAttribute : string * string * string -> string
Public Overridable Function SetAttribute (localName As String, namespaceURI As String, value As String) As String

参数

localName
String

属性的本地名称。The local name of the attribute.

namespaceURI
String

属性的命名空间 URI。The namespace URI of the attribute.

value
String

要为此特性设置的值。The value to set for the attribute.

返回

String

特性值。The attribute value.

适用于