Compartilhar via


XmlDocument.CreateAttribute Método

Definição

Cria um XmlAttribute com o nome especificado.

Sobrecargas

CreateAttribute(String)

Cria um XmlAttribute com o Name especificado.

CreateAttribute(String, String)

Cria um XmlAttribute com o nome e dados especificados e NamespaceURI.

CreateAttribute(String, String, String)

Cria um XmlAttribute com o Prefix, LocalName e NamespaceURI especificados.

CreateAttribute(String)

Cria um XmlAttribute com o Name especificado.

public:
 System::Xml::XmlAttribute ^ CreateAttribute(System::String ^ name);
public System.Xml.XmlAttribute CreateAttribute (string name);
member this.CreateAttribute : string -> System.Xml.XmlAttribute
Public Function CreateAttribute (name As String) As XmlAttribute

Parâmetros

name
String

O nome qualificado do atributo. Se o nome contiver dois-pontos, a propriedade Prefix refletirá a parte do nome do anterior ao primeiro e a propriedade LocalName refletirá a parte posterior a ele. O NamespaceURI permanece vazio, a menos que o prefixo seja interno e reconhecido como xmlns. Nesse caso, NamespaceURI tem um valor de http://www.w3.org/2000/xmlns/.

Retornos

XmlAttribute

O novo XmlAttribute.

Exemplos

O seguinte cria um atributo e o adiciona a um documento XML.

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   XmlDocument^ doc = gcnew XmlDocument;
   doc->LoadXml( "<book genre='novel' ISBN='1-861001-57-5'><title>Pride And Prejudice</title></book>" );
   
   //Create an attribute.
   XmlAttribute^ attr = doc->CreateAttribute( "publisher" );
   attr->Value = "WorldWide Publishing";
   
   //Add the new node to the document. 
   doc->DocumentElement->SetAttributeNode( attr );
   Console::WriteLine( "Display the modified XML..." );
   doc->Save( Console::Out );
}

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

public class Sample
{
  public static void Main()
  {
    XmlDocument doc = new XmlDocument();
    doc.LoadXml("<book genre='novel' ISBN='1-861001-57-5'>" +
                "<title>Pride And Prejudice</title>" +
                "</book>");

    //Create an attribute.
    XmlAttribute attr = doc.CreateAttribute("publisher");
    attr.Value = "WorldWide Publishing";

    //Add the new node to the document.
    doc.DocumentElement.SetAttributeNode(attr);

    Console.WriteLine("Display the modified XML...");
    doc.Save(Console.Out);
  }
}
Imports System.IO
Imports System.Xml

Public Class Sample
    Public Shared Sub Main()
        Dim doc As New XmlDocument()
        doc.LoadXml("<book genre='novel' ISBN='1-861001-57-5'>"  & _
                    "<title>Pride And Prejudice</title>"  & _
                    "</book>")
        
        'Create an attribute.
        Dim attr As XmlAttribute = doc.CreateAttribute("publisher")
        attr.Value = "WorldWide Publishing"
        
        'Add the new node to the document. 
        doc.DocumentElement.SetAttributeNode(attr)
        
        Console.WriteLine("Display the modified XML...")
        doc.Save(Console.Out)
    End Sub
End Class

Comentários

O XmlAttribute método pode ser adicionado a um XmlElement método SetAttributeNode .

Aplica-se a

CreateAttribute(String, String)

Cria um XmlAttribute com o nome e dados especificados e NamespaceURI.

public:
 System::Xml::XmlAttribute ^ CreateAttribute(System::String ^ qualifiedName, System::String ^ namespaceURI);
public System.Xml.XmlAttribute CreateAttribute (string qualifiedName, string namespaceURI);
public System.Xml.XmlAttribute CreateAttribute (string qualifiedName, string? namespaceURI);
member this.CreateAttribute : string * string -> System.Xml.XmlAttribute
Public Function CreateAttribute (qualifiedName As String, namespaceURI As String) As XmlAttribute

Parâmetros

qualifiedName
String

O nome qualificado do atributo. Se o nome contiver dois-pontos, a propriedade Prefix refletirá a parte do nome anterior aos dois-pontos e a propriedade LocalName refletirá a parte do nome posterior a ele.

namespaceURI
String

O namespaceURI do atributo. Se o nome qualificado incluir um prefixo de xmlns, esse parâmetro precisará ser http://www.w3.org/2000/xmlns/.

Retornos

XmlAttribute

O novo XmlAttribute.

Comentários

O XmlAttribute método pode ser adicionado a um XmlElement método SetAttributeNode .

Aplica-se a

CreateAttribute(String, String, String)

Cria um XmlAttribute com o Prefix, LocalName e NamespaceURI especificados.

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

Parâmetros

prefix
String

O prefixo do atributo (se houver). String.Empty e null são equivalentes.

localName
String

O nome local do atributo.

namespaceURI
String

O URI do namespace do atributo (se houver). String.Empty e null são equivalentes. Se o prefix for xmlns, esse parâmetro precisará ser http://www.w3.org/2000/xmlns/, caso contrário, uma exceção será gerada.

Retornos

XmlAttribute

O novo XmlAttribute.

Comentários

O XmlAttribute método pode ser adicionado a um XmlElement método SetAttributeNode .

Esse método é uma extensão da Microsoft para o DOM (Modelo de Objeto de Documento).

Aplica-se a