XPathNavigator.ReplaceSelf Methode

Definitie

Naamruimte:: System.Xml.XPath

Assembly's:: netstandard.dll, System.Xml.ReaderWriter.dll

Assembly:: System.Xml.XPath.dll

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Vervangt het huidige knooppunt door de opgegeven inhoud.

Overloads

Name	Description
ReplaceSelf(XmlReader)	Vervangt het huidige knooppunt door de inhoud van het XmlReader opgegeven object.
ReplaceSelf(XPathNavigator)	Vervangt het huidige knooppunt door de inhoud van het XPathNavigator opgegeven object.
ReplaceSelf(String)	Vervangt het huidige knooppunt door de inhoud van de opgegeven tekenreeks.

ReplaceSelf(XmlReader)

Bron:: XPathNavigator.cs

Bron:: XPathNavigator.cs

Bron:: XPathNavigator.cs

Bron:: XPathNavigator.cs

Bron:: XPathNavigator.cs

Vervangt het huidige knooppunt door de inhoud van het XmlReader opgegeven object.

public:
 virtual void ReplaceSelf(System::Xml::XmlReader ^ newNode);

public virtual void ReplaceSelf(System.Xml.XmlReader newNode);

abstract member ReplaceSelf : System.Xml.XmlReader -> unit
override this.ReplaceSelf : System.Xml.XmlReader -> unit

Public Overridable Sub ReplaceSelf (newNode As XmlReader)

Parameters

newNode: XmlReader

Een XmlReader object dat is geplaatst op de XML-gegevens voor het nieuwe knooppunt.

Uitzonderingen

ArgumentException

Het XmlReader object heeft een foutstatus of is gesloten.

ArgumentNullException

De XmlReader objectparameter is null.

InvalidOperationException

Het XPathNavigator element wordt niet geplaatst op een element-, tekst-, verwerkingsinstructie- of opmerkingenknooppunt.

NotSupportedException

De XPathNavigator bewerking wordt niet ondersteund.

XmlException

De XML-inhoud van de XmlReader objectparameter is niet goed opgemaakt.

Voorbeelden

In het volgende voorbeeld wordt het price element in het contosoBooks.xml bestand vervangen door een nieuw pages element.

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

XmlReader pages = XmlReader.Create(new StringReader("<pages xmlns=\"http://www.contoso.com/books\">100</pages>"));

navigator.ReplaceSelf(pages);

Console.WriteLine("Position after delete: {0}", navigator.Name);
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 pages As XmlReader = XmlReader.Create(New StringReader("<pages xmlns='http://www.contoso.com/books'>100</pages>"))

navigator.ReplaceSelf(pages)

Console.WriteLine("Position after delete: {0}", navigator.Name)
Console.WriteLine(navigator.OuterXml)

In het voorbeeld wordt het contosoBooks.xml bestand als invoer gebruikt.

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

Opmerkingen

De XPathNavigator positie wordt op het nieuwe knooppunt weergegeven bij voltooiing van de ReplaceSelf methode en retourneert true. Het XPathNavigator wordt niet op het nieuwe knooppunt weergegeven na voltooiing van de ReplaceSelf methode wanneer de XML-invoer zich Empty bevindt XPathNavigator op het volgende knooppunt op hetzelfde niveau of het bovenliggende knooppunt als er geen naastliggend knooppunt is voor het vervangen knooppunt en de ReplaceSelf retourneert false.

De ReplaceSelf methode is alleen geldig wanneer de XPathNavigator methode is geplaatst op een element, tekst, verwerkingsinstructie of opmerkingenknooppunt.
Als de XML-gegevensreeks niet goed is opgemaakt dan een uitzondering wordt gegenereerd en het resultaat van deze methode gelijk is aan het aanroepen DeleteSelf op het huidige knooppunt.
Als de XML-tekenreeks meerdere knooppunten bevat, worden alle knooppunten toegevoegd en bevindt de XPathNavigator tekenreeks zich op het eerste knooppunt in de reeks knooppunten.
De ReplaceSelf methode is niet gelijk aan de DeleteSelf methode.

Van toepassing op

ReplaceSelf(XPathNavigator)

Bron:: XPathNavigator.cs

Bron:: XPathNavigator.cs

Bron:: XPathNavigator.cs

Bron:: XPathNavigator.cs

Bron:: XPathNavigator.cs

Vervangt het huidige knooppunt door de inhoud van het XPathNavigator opgegeven object.

public:
 virtual void ReplaceSelf(System::Xml::XPath::XPathNavigator ^ newNode);

public virtual void ReplaceSelf(System.Xml.XPath.XPathNavigator newNode);

abstract member ReplaceSelf : System.Xml.XPath.XPathNavigator -> unit
override this.ReplaceSelf : System.Xml.XPath.XPathNavigator -> unit

Public Overridable Sub ReplaceSelf (newNode As XPathNavigator)

Parameters

newNode: XPathNavigator

Een XPathNavigator object dat op het nieuwe knooppunt is geplaatst.

Uitzonderingen

ArgumentNullException

De XPathNavigator objectparameter is null.

InvalidOperationException

Het XPathNavigator element wordt niet geplaatst op een element-, tekst-, verwerkingsinstructie- of opmerkingenknooppunt.

NotSupportedException

De XPathNavigator bewerking wordt niet ondersteund.

XmlException

De XML-inhoud van de XPathNavigator objectparameter is niet goed opgemaakt.

Voorbeelden

In het volgende voorbeeld wordt het price element in het contosoBooks.xml bestand vervangen door een nieuw pages element.

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

XmlDocument childNodes = new XmlDocument();
childNodes.Load(new StringReader("<pages xmlns=\"http://www.contoso.com/books\">100</pages>"));
XPathNavigator childNodesNavigator = childNodes.CreateNavigator();

navigator.ReplaceSelf(childNodesNavigator);

Console.WriteLine("Position after delete: {0}", navigator.Name);
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 childNodes As XmlDocument = New XmlDocument()
childNodes.Load(New StringReader("<pages xmlns='http://www.contoso.com/books'>100</pages>"))
Dim childNodesNavigator As XPathNavigator = childNodes.CreateNavigator()

navigator.ReplaceSelf(childNodesNavigator)

Console.WriteLine("Position after delete: {0}", navigator.Name)
Console.WriteLine(navigator.OuterXml)

In het voorbeeld wordt het contosoBooks.xml bestand als invoer gebruikt.

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

Opmerkingen

De ReplaceSelf methode is alleen geldig wanneer de XPathNavigator methode is geplaatst op een element, tekst, verwerkingsinstructie of opmerkingenknooppunt.
Als de XML-gegevensreeks niet goed is opgemaakt dan een uitzondering wordt gegenereerd en het resultaat van deze methode gelijk is aan het aanroepen DeleteSelf op het huidige knooppunt.
Als de XML-tekenreeks meerdere knooppunten bevat, worden alle knooppunten toegevoegd en bevindt de XPathNavigator tekenreeks zich op het eerste knooppunt in de reeks knooppunten.
De ReplaceSelf methode is niet gelijk aan de DeleteSelf methode.

Van toepassing op

ReplaceSelf(String)

Bron:: XPathNavigator.cs

Bron:: XPathNavigator.cs

Bron:: XPathNavigator.cs

Bron:: XPathNavigator.cs

Bron:: XPathNavigator.cs

Vervangt het huidige knooppunt door de inhoud van de opgegeven tekenreeks.

public:
 virtual void ReplaceSelf(System::String ^ newNode);

public virtual void ReplaceSelf(string newNode);

abstract member ReplaceSelf : string -> unit
override this.ReplaceSelf : string -> unit

Public Overridable Sub ReplaceSelf (newNode As String)

Parameters

newNode: String

De XML-gegevensreeks voor het nieuwe knooppunt.

Uitzonderingen

ArgumentNullException

De xml-tekenreeksparameter is null.

InvalidOperationException

Het XPathNavigator element wordt niet geplaatst op een element-, tekst-, verwerkingsinstructie- of opmerkingenknooppunt.

NotSupportedException

De XPathNavigator bewerking wordt niet ondersteund.

XmlException

De xml-tekenreeksparameter is niet goed opgemaakt.

Voorbeelden

In het volgende voorbeeld wordt het price element in het contosoBooks.xml bestand vervangen door een nieuw pages element.

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.ReplaceSelf("<pages>100</pages>");

Console.WriteLine("Position after delete: {0}", navigator.Name);
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.ReplaceSelf("<pages>100</pages>")

Console.WriteLine("Position after delete: {0}", navigator.Name)
Console.WriteLine(navigator.OuterXml)

In het voorbeeld wordt het contosoBooks.xml bestand als invoer gebruikt.

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

Opmerkingen

De ReplaceSelf methode is alleen geldig wanneer de XPathNavigator methode is geplaatst op een element, tekst, verwerkingsinstructie of opmerkingenknooppunt.
Als de XML-gegevensreeks niet goed is opgemaakt dan een uitzondering wordt gegenereerd en het resultaat van deze methode gelijk is aan het aanroepen DeleteSelf op het huidige knooppunt.
Als de XML-tekenreeks meerdere knooppunten bevat, worden alle knooppunten toegevoegd en bevindt de XPathNavigator tekenreeks zich op het eerste knooppunt in de reeks knooppunten.
De ReplaceSelf methode is niet gelijk aan de DeleteSelf methode.

Van toepassing op

Feedback

Is deze pagina nuttig?