Freigeben über


XmlElement.SetAttribute Methode

Definition

Legt den Wert des angegebenen Attributs fest.

Überlädt

SetAttribute(String, String)

Legt den Wert des Attributs mit dem angegebenen Namen fest.

SetAttribute(String, String, String)

Legt den Wert des Attributs mit dem angegebenen lokalen Namen und Namespace-URI fest.

SetAttribute(String, String)

Legt den Wert des Attributs mit dem angegebenen Namen fest.

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)

Parameter

name
String

Der Name des Attributs, das erstellt oder geändert werden soll. Dies ist ein qualifizierter Name. Wenn der Name einen Doppelpunkt enthält, wird er in eine Präfix- und eine lokale Namenskomponente aufgelöst.

value
String

Der für das Attribut festzulegende Wert.

Ausnahmen

Der angegebene Name enthält ein ungültiges Zeichen.

Der Knoten ist schreibgeschützt.

Hinweise

Wenn ein Attribut mit demselben Namen bereits im Element vorhanden ist, wird der Wert in das valueElement geändert. value ist eine einfache Zeichenfolge. Es wird nicht analysiert, da er festgelegt wird. Jedes Markup, z. B. syntax, die als Entitätsverweis erkannt werden soll, wird als Literaltext behandelt und muss durch die Implementierung ordnungsgemäß abgewendt werden, wenn es geschrieben wird. Um einen Attributwert zuzuweisen, der Entitätsbezüge enthält, muss der Benutzer einen XmlAttribute Knoten plus beliebige XmlText XmlEntityReference und Knoten erstellen, die entsprechende Unterstruktur erstellen und verwenden SetAttributeNode , um ihn als Wert eines Attributs zuzuweisen.

Gilt für

SetAttribute(String, String, String)

Legt den Wert des Attributs mit dem angegebenen lokalen Namen und Namespace-URI fest.

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

Parameter

localName
String

Der lokale Name des Attributs.

namespaceURI
String

Der Namespace-URI dieses Attributs.

value
String

Der für das Attribut festzulegende Wert.

Gibt zurück

String

Der Attributwert.

Gilt für