XmlDocument.CreateAttribute Metoda

Definicja

Tworzy element XmlAttribute o określonej nazwie.

Przeciążenia

CreateAttribute(String)

Tworzy element XmlAttribute z określonym Nameelementem .

CreateAttribute(String, String)

Tworzy element XmlAttribute o określonej kwalifikowanej nazwie i NamespaceURI.

CreateAttribute(String, String, String)

Tworzy element XmlAttribute z określonym Prefixelementem , LocalNamei NamespaceURI.

CreateAttribute(String)

Tworzy element XmlAttribute z określonym Nameelementem .

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

Parametry

name
String

Kwalifikowana nazwa atrybutu. Jeśli nazwa zawiera dwukropek, Prefix właściwość odzwierciedla część nazwy poprzedzającej pierwszy dwukropek, a LocalName właściwość odzwierciedla część nazwy po pierwszym dwukropku. Element NamespaceURI pozostaje pusty, chyba że prefiks jest rozpoznawanym wbudowanym prefiksem, takim jak xmlns. W tym przypadku NamespaceURI wartość to http://www.w3.org/2000/xmlns/.

Zwraca

Nowy XmlAttributeelement .

Przykłady

Poniżej przedstawiono sposób tworzenia atrybutu i dodawania go do dokumentu 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

Uwagi

Element XmlAttribute można dodać do XmlElement metody przy użyciu SetAttributeNode metody .

Dotyczy

CreateAttribute(String, String)

Tworzy element XmlAttribute o określonej kwalifikowanej nazwie i 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

Parametry

qualifiedName
String

Kwalifikowana nazwa atrybutu. Jeśli nazwa zawiera dwukropek, właściwość będzie odzwierciedlać część nazwy poprzedzającej dwukropek Prefix , a LocalName właściwość będzie odzwierciedlać część nazwy po dwukropku.

namespaceURI
String

Identyfikator NAMEspaceURI atrybutu. Jeśli kwalifikowana nazwa zawiera prefiks xmlns, ten parametr musi mieć wartość http://www.w3.org/2000/xmlns/.

Zwraca

Nowy XmlAttributeelement .

Uwagi

Element XmlAttribute można dodać do XmlElement metody przy użyciu SetAttributeNode metody .

Dotyczy

CreateAttribute(String, String, String)

Tworzy element XmlAttribute z określonym Prefixelementem , LocalNamei NamespaceURI.

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

Parametry

prefix
String

Prefiks atrybutu (jeśli istnieje). String.Empty i null są równoważne.

localName
String

Lokalna nazwa atrybutu.

namespaceURI
String

Identyfikator URI przestrzeni nazw atrybutu (jeśli istnieje). String.Empty i null są równoważne. Jeśli prefix parametr jest xmlns, ten parametr musi być http://www.w3.org/2000/xmlns/; w przeciwnym razie zgłaszany jest wyjątek.

Zwraca

Nowy XmlAttributeelement .

Uwagi

Element XmlAttribute można dodać do XmlElement metody przy użyciu SetAttributeNode metody .

Ta metoda jest rozszerzeniem Microsoft do modelu obiektów dokumentów (DOM).

Dotyczy