XmlElement.SetAttributeNode Método

Definição

Namespace:

System.Xml

Assemblies:

netstandard.dll, System.Xml.ReaderWriter.dll

Adiciona um novo XmlAttribute.

Sobrecargas

Nome	Description
SetAttributeNode(XmlAttribute)	Adiciona o especificado XmlAttribute.
SetAttributeNode(String, String)	Adiciona o especificado XmlAttribute.

SetAttributeNode(XmlAttribute)

Origem:

XmlElement.cs

Adiciona o especificado 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

Parâmetros

newAttr

XmlAttribute

O XmlAttribute nó a ser adicionado à coleção de atributos para esse elemento.

Retornos

XmlAttribute

Se o atributo substituir um atributo existente pelo mesmo nome, o antigo XmlAttribute será retornado; caso contrário, null será retornado.

Exceções

ArgumentException

O newAttr foi criado a partir de um documento diferente daquele que criou esse nó. Ou esse nó é somente leitura.

InvalidOperationException

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

Comentários

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

SetAttributeNode(String, String)

Origem:

XmlElement.cs

Adiciona o especificado 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

Parâmetros

localName

String

O nome local do atributo.

namespaceURI

String

O URI do namespace do atributo.

Retornos

XmlAttribute

O XmlAttribute para adicionar.

Exemplos

O exemplo a seguir adiciona um atributo a um elemento.

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.