XmlElement.SetAttributeNode Methode

  • Referenz

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

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);
public virtual System.Xml.XmlAttribute? SetAttributeNode (System.Xml.XmlAttribute newAttr);
abstract member SetAttributeNode : System.Xml.XmlAttribute -> System.Xml.XmlAttribute
override this.SetAttributeNode : System.Xml.XmlAttribute -> System.Xml.XmlAttribute
Public Overridable Function SetAttributeNode (newAttr As XmlAttribute) As XmlAttribute

Parameter

newAttr
XmlAttribute

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

Gibt zurück

XmlAttribute

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

Ausnahmen

ArgumentException

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

InvalidOperationException

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:

SetAttributeNode(String, String)

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

Fügt das angegebene XmlAttribute hinzu.

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

Parameter

localName
String

Der lokale Name des Attributs.

namespaceURI
String

Der Namespace-URI dieses Attributs.

Gibt zurück

XmlAttribute

Das hinzuzufügende XmlAttribute.

Beispiele

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

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   XmlDocument^ doc = gcnew 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 );
}

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);
  }
}

Imports System.IO
Imports System.Xml

public class Sample

  public shared sub Main()

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

    Dim root as XmlElement = doc.DocumentElement

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

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

  end sub
end class

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: