XPathNavigator.CreateAttribute(String, String, String, String) Methode

public:
 virtual void CreateAttribute(System::String ^ prefix, System::String ^ localName, System::String ^ namespaceURI, System::String ^ value);

public virtual void CreateAttribute(string? prefix, string localName, string? namespaceURI, string? value);

public virtual void CreateAttribute(string prefix, string localName, string namespaceURI, string value);

abstract member CreateAttribute : string * string * string * string -> unit
override this.CreateAttribute : string * string * string * string -> unit

Public Overridable Sub CreateAttribute (prefix As String, localName As String, namespaceURI As String, value As String)

Parameter

Ausnahmen

Beispiele

Im folgenden Beispiel wird ein neues discount Attribut für das price untergeordnete Element des ersten book Elements in der contosoBooks.xml Datei erstellt.

XmlDocument document = new XmlDocument();
document.Load("contosoBooks.xml");
XPathNavigator navigator = document.CreateNavigator();

navigator.MoveToChild("bookstore", "http://www.contoso.com/books");
navigator.MoveToChild("book", "http://www.contoso.com/books");
navigator.MoveToChild("price", "http://www.contoso.com/books");

navigator.CreateAttribute("", "discount", "", "1.00");

navigator.MoveToParent();
Console.WriteLine(navigator.OuterXml);

Dim document As XmlDocument = New XmlDocument()
document.Load("contosoBooks.xml")
Dim navigator As XPathNavigator = document.CreateNavigator()

navigator.MoveToChild("bookstore", "http://www.contoso.com/books")
navigator.MoveToChild("book", "http://www.contoso.com/books")
navigator.MoveToChild("price", "http://www.contoso.com/books")

navigator.CreateAttribute("", "discount", "", "1.00")

navigator.MoveToParent()
Console.WriteLine(navigator.OuterXml)

Im Beispiel wird die contosoBooks.xml Datei als Eingabe verwendet.

<?xml version="1.0" encoding="utf-8" ?>
<bookstore xmlns="http://www.contoso.com/books">
    <book genre="autobiography" publicationdate="1981-03-22" ISBN="1-861003-11-0">
        <title>The Autobiography of Benjamin Franklin</title>
        <author>
            <first-name>Benjamin</first-name>
            <last-name>Franklin</last-name>
        </author>
        <price>8.99</price>
    </book>
    <book genre="novel" publicationdate="1967-11-17" ISBN="0-201-63361-2">
        <title>The Confidence Man</title>
        <author>
            <first-name>Herman</first-name>
            <last-name>Melville</last-name>
        </author>
        <price>11.99</price>
    </book>
    <book genre="philosophy" publicationdate="1991-02-15" ISBN="1-861001-57-6">
        <title>The Gorgias</title>
        <author>
            <name>Plato</name>
        </author>
        <price>9.99</price>
    </book>
</bookstore>

Hinweise

Namespacepräfix- und URI-Werte können mit der LookupPrefix oder LookupNamespace der Methode abgerufen werden. Die folgende Syntax erstellt z. B. ein Attribut mithilfe des Namespaces im Gültigkeitsbereich xmlns:bk="http://www.contoso.com/books":

editor.CreateAttribute(navigator.Prefix, "attributeName", LookupNamespace(navigator.Prefix), "text")

Dadurch wird das neue Attribut <bk:element attributeName="text"/> für das aktuelle Element erstellt.

Im Folgenden finden Sie wichtige Hinweise, die Sie bei der Verwendung der CreateAttribute Methode berücksichtigen sollten.

• Wenn das angegebene String.Empty Namespacepräfix oder nulldas Präfix für den Namespace-URI des neuen Attributs aus den aktuellen Namespaces im Gültigkeitsbereich abgerufen wird. Wenn dem angegebenen Namespace-URI im aktuellen Bereich kein Namespacepräfix zugewiesen ist, wird automatisch ein Namespacepräfix generiert. Um z. B. ein neues Attribut für ein Element im Standardnamespace der contosoBooks.xml Datei () zu erstellen,xmlns="http://www.contoso.com/books" geben Sie sowohl null die Namespacepräfix- als auch die Namespace-URI-Parameter anString.Empty. Die Angabe http://www.contoso.com/books als Namespace-URI-Parameter bewirkt, dass die CreateAttribute Methode automatisch ein Namespacepräfix für das neue Attribut generiert.

• Wenn es sich beim erstellten neuen Attribut um einen Namespaceknoten handelt, der mit einer Namespacedeklaration für das Element in Konflikt steht, wird entweder das ausgewählte Namespacepräfix von einer anderen Namespacedeklaration im selben Bereich verwendet, oder weil das ausgewählte Präfix mit dem des Elements identisch ist, aber an einen anderen Namespace-URI gebunden ist, wird eine Ausnahme ausgelöst.

• Die CreateAttribute Methode wirkt sich nicht auf die Position der XPathNavigator.