XPathNavigator.CreateAttributes Metódus

Definíció

Névtér:

System.Xml.XPath

Szerelvények:

netstandard.dll, System.Xml.ReaderWriter.dll

Forrás:

XPathNavigator.cs

XmlWriter Az aktuális elem új attribútumainak létrehozásához használt objektumot ad vissza.

public:
 virtual System::Xml::XmlWriter ^ CreateAttributes();

public virtual System.Xml.XmlWriter CreateAttributes();

abstract member CreateAttributes : unit -> System.Xml.XmlWriter
override this.CreateAttributes : unit -> System.Xml.XmlWriter

Public Overridable Function CreateAttributes () As XmlWriter

Válaszok

XmlWriter

Az XmlWriter aktuális elem új attribútumainak létrehozásához használt objektum.

Kivételek

InvalidOperationException

Ez XPathNavigator nem elemcsomóponton van elhelyezve.

NotSupportedException

Ez XPathNavigator nem támogatja a szerkesztést.

Példák

Az alábbi példában a rendszer új discount és currency attribútumokat hoz létre a price fájl első book elemének gyermekelemén a contosoBooks.xmlXmlWriter metódus által CreateAttributes visszaadott objektummal.

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");

XmlWriter attributes = navigator.CreateAttributes();

attributes.WriteAttributeString("discount", "1.00");
attributes.WriteAttributeString("currency", "USD");
attributes.Close();

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")

Dim attributes As XmlWriter = navigator.CreateAttributes()

attributes.WriteAttributeString("discount", "1.00")
attributes.WriteAttributeString("currency", "USD")
attributes.Close()

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

A példa bemenetként használja a contosoBooks.xml fájlt.

<?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>

Megjegyzések

A módszer használatakor CreateAttributes az alábbi fontos megjegyzéseket érdemes figyelembe venni.

• Ha az XPathNavigator elem egy elemen van elhelyezve, a metódus által XPathNavigator létrehozott új attribútumok az aktuális elem attribútumlistájának végére kerülnek.

• Az új attribútumok csak az Close objektum metódusának meghívása XmlWriter után lesznek beszúrva.

• Ha a megadott névtér-előtag vagy String.Emptynull, az új attribútum névtér URI előtagját a rendszer a hatókörben lévő aktuális névterekből szerzi be. Ha az aktuális hatókörben nincs hozzárendelve névtérelőtag a megadott névtér URI-hoz, a rendszer automatikusan létrehoz egy névtérelőtagot. Ha például új attribútumot szeretne létrehozni a fájl alapértelmezett névterének egyik elemén contosoBooks.xml (xmlns="http://www.contoso.com/books"), meg kell adnia null a String.Empty névtér előtagját és a névtér URI-paramétereit is. http://www.contoso.com/books Ha névtér URI paraméterként adja meg, a CreateAttribute metódus automatikusan létrehoz egy névtérelőtagot az új attribútumhoz.

• Ha a létrehozott új attribútum egy névtércsomópont, amely ütközik az elem névtér-deklarációjával, vagy azért, mert a kiválasztott névtér-előtagot egy másik névtér-deklaráció használja ugyanabban a hatókörben, vagy mert a kiválasztott előtag megegyezik az elemével, de egy másik névtér URI-jához van kötve, kivétel keletkezik.

• A XmlWriter visszaadott objektum csak attribútumok létrehozásához használható. Az attribútumokat nem létrehozó egyéb XmlWriter objektummetódusok meghívása kivételt okoz.

• A CreateAttributes metódus nem befolyásolja a XPathNavigator.