XmlElement.SetAttribute Methode

Definition

Namespace:

System.Xml

Assemblys:

System.Xml.dll, System.Xml.XmlDocument.dll

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.XmlDocument.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

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

XmlException

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

ArgumentException

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.

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.