XmlElement.SetAttributeNode Methode

Definition

Fügt ein neues XmlAttribute hinzu.Adds a new XmlAttribute.

Überlädt

SetAttributeNode(XmlAttribute)

Fügt das angegebene XmlAttribute hinzu.Adds the specified XmlAttribute.

SetAttributeNode(String, String)

Fügt das angegebene XmlAttribute hinzu.Adds the specified XmlAttribute.

SetAttributeNode(XmlAttribute)

Fügt das angegebene XmlAttribute hinzu.Adds the specified XmlAttribute.

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.The XmlAttribute node to add to the attribute collection for this element.

Gibt zurück

Wenn das Attribut ein vorhandenes Attribut mit demselben Namen ersetzt, wird das alte XmlAttribute zurückgegeben, andernfalls wird null zurückgegeben.If the attribute replaces an existing attribute with the same name, the old XmlAttribute is returned; otherwise, null is returned.

Ausnahmen

newAttr wurde nicht aus dem Dokument erstellt, aus dem dieser Knoten erstellt wurde.The newAttr was created from a different document than the one that created this node. Oder dieser Knoten ist schreibgeschützt.Or this node is read-only.

newAttr ist bereits ein Attribut eines anderen XmlElement-Objekts.The newAttr is already an attribute of another XmlElement object. Sie müssen XmlAttribute-Knoten explizit klonen, um sie in anderen XmlElement-Objekten erneut verwenden zu können.You must explicitly clone XmlAttribute nodes to re-use them in other XmlElement objects.

Hinweise

Wenn ein Attribut mit diesem Namen bereits im-Element vorhanden ist, wird es durch das neue ersetzt.If an attribute with that name is already present in the element, it is replaced by the new one.

SetAttributeNode(String, String)

Fügt das angegebene XmlAttribute hinzu.Adds the specified XmlAttribute.

public:
 virtual System::Xml::XmlAttribute ^ SetAttributeNode(System::String ^ localName, System::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.The local name of the attribute.

namespaceURI
String

Der Namespace-URI dieses Attributs.The namespace URI of the attribute.

Gibt zurück

Das hinzuzufügende XmlAttribute.The XmlAttribute to add.

Beispiele

Im folgenden Beispiel wird einem-Element ein-Attribut hinzugefügt.The following example adds an attribute to an element.

#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

Die XmlAttribute hat keine untergeordneten Elemente.The XmlAttribute does not have any children. Verwenden Sie Value, um dem-Attribut einen Textwert zuzuweisen, oder verwenden Sie AppendChild (oder eine ähnliche Methode), um dem-Attribut untergeordnete Elemente hinzuzufügen.Use Value to assign a text value to the attribute or use AppendChild (or a similar method) to add children to the attribute.

Gilt für: