XmlElement.SetAttributeNode Método

  • Referência

Definição

Namespace:
System.Xml
Assemblies:
System.Xml.dll, System.Xml.XmlDocument.dll
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.XmlDocument.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll

Adiciona um novo XmlAttribute.

Sobrecargas

SetAttributeNode(XmlAttribute)

Adiciona o XmlAttribute especificado.
SetAttributeNode(String, String)

Adiciona o XmlAttribute especificado.

SetAttributeNode(XmlAttribute)

Adiciona o XmlAttribute especificado.

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

Parâmetros

newAttr
XmlAttribute

O nó XmlAttribute para adicionar à coleção de atributos desse elemento.

Retornos

XmlAttribute

Se o atributo substitui um atributo existente com o mesmo nome, o XmlAttribute antigo será retornado; caso contrário, null é retornado.

Exceções

ArgumentException

O newAttr foi criado com base em um documento diferente daquele que criou esse nó. Ou esse nó é somente leitura.

InvalidOperationException

O newAttr já é um atributo de outro objeto XmlElement. Você deve clonar explicitamente nós de XmlAttribute para reutilizá-los em outros objetos XmlElement.

Comentários

Se um atributo com esse nome já estiver presente no elemento, ele será substituído pelo novo.

Aplica-se a

SetAttributeNode(String, String)

Adiciona o XmlAttribute especificado.

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

Parâmetros

localName
String

O nome local do atributo.

namespaceURI
String

O URI do namespace do atributo.

Retornos

XmlAttribute

O XmlAttribute a ser adicionado.

Exemplos

O exemplo a seguir adiciona um atributo a um elemento.

#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

Comentários

O XmlAttribute não tem filhos. Use Value para atribuir um valor de texto ao atributo ou usar AppendChild (ou um método semelhante) para adicionar filhos ao atributo.

Aplica-se a