Auf Englisch lesen

Freigeben über


XmlElement.SetAttributeNode Methode

Definition

Fügt ein neues XmlAttribute hinzu.

Überlädt

SetAttributeNode(XmlAttribute)

Fügt das angegebene XmlAttribute hinzu.

SetAttributeNode(String, String)

Fügt das angegebene XmlAttribute hinzu.

SetAttributeNode(XmlAttribute)

Quelle:
XmlElement.cs
Quelle:
XmlElement.cs
Quelle:
XmlElement.cs

Fügt das angegebene XmlAttribute hinzu.

public virtual System.Xml.XmlAttribute SetAttributeNode (System.Xml.XmlAttribute newAttr);
public virtual System.Xml.XmlAttribute? SetAttributeNode (System.Xml.XmlAttribute newAttr);

Parameter

newAttr
XmlAttribute

Der XmlAttribute-Knoten, der der Attributauflistung dieses Elements hinzugefügt werden soll.

Gibt zurück

Wenn das Attribut ein vorhandenes Attribut mit demselben Namen ersetzt, wird das alte XmlAttribute zurückgegeben, andernfalls wird null zurückgegeben.

Ausnahmen

newAttr wurde nicht aus dem Dokument erstellt, aus dem dieser Knoten erstellt wurde. Oder dieser Knoten ist schreibgeschützt.

newAttr ist bereits ein Attribut eines anderen XmlElement-Objekts. Sie müssen XmlAttribute-Knoten explizit klonen, um sie in anderen XmlElement-Objekten erneut verwenden zu können.

Hinweise

Wenn ein Attribut mit diesem Namen bereits im Element vorhanden ist, wird es durch das neue ersetzt.

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1
UWP 10.0

SetAttributeNode(String, String)

Quelle:
XmlElement.cs
Quelle:
XmlElement.cs
Quelle:
XmlElement.cs

Fügt das angegebene XmlAttribute hinzu.

public virtual System.Xml.XmlAttribute SetAttributeNode (string localName, string namespaceURI);
public virtual System.Xml.XmlAttribute SetAttributeNode (string localName, string? namespaceURI);

Parameter

localName
String

Der lokale Name des Attributs.

namespaceURI
String

Der Namespace-URI dieses Attributs.

Gibt zurück

Das hinzuzufügende XmlAttribute.

Beispiele

Im folgenden Beispiel wird einem -Element ein -Attribut hinzugefügt.

using System;
using System.IO;
using System.Xml;

public class Sample
{
  public static void Main()
  {

    XmlDocument doc = new XmlDocument();
    doc.LoadXml("<book xmlns:bk='urn:samples' bk:ISBN='1-861001-57-5'>" +
                "<title>Pride And Prejudice</title>" +
                "</book>");

    XmlElement root = doc.DocumentElement;

    // Add a new attribute.
    XmlAttribute attr = root.SetAttributeNode("genre", "urn:samples");
    attr.Value="novel";

    Console.WriteLine("Display the modified XML...");
    Console.WriteLine(doc.InnerXml);
  }
}

Hinweise

Der XmlAttribute hat keine Kinder. Verwenden Sie Value , um dem Attribut einen Textwert zuzuweisen, oder verwenden Sie AppendChild (oder eine ähnliche Methode), um dem Attribut untergeordnete Elemente hinzuzufügen.

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1
UWP 10.0