XPathNavigator.ReplaceSelf Méthode

Définition

Espace de noms:: System.Xml.XPath

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Remplace le nœud actuel par le contenu spécifié.

Surcharges

Nom	Description
ReplaceSelf(XmlReader)	Remplace le nœud actuel par le contenu de l’objet XmlReader spécifié.
ReplaceSelf(XPathNavigator)	Remplace le nœud actuel par le contenu de l’objet XPathNavigator spécifié.
ReplaceSelf(String)	Remplace le nœud actuel par le contenu de la chaîne spécifiée.

ReplaceSelf(XmlReader)

Remplace le nœud actuel par le contenu de l’objet XmlReader spécifié.

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)

Paramètres

newNode: XmlReader

Objet XmlReader positionné sur les données XML du nouveau nœud.

Exceptions

ArgumentException

L’objet XmlReader est dans un état d’erreur ou fermé.

ArgumentNullException

Le XmlReader paramètre d’objet est null.

InvalidOperationException

L’élément XPathNavigator n’est pas positionné sur un élément, un texte, une instruction de traitement ou un nœud de commentaire.

NotSupportedException

La XPathNavigator modification ne prend pas en charge la modification.

XmlException

Le contenu XML du XmlReader paramètre objet n’est pas bien formé.

Exemples

Dans l’exemple suivant, l’élément price du contosoBooks.xml fichier est remplacé par un nouvel pages élément.

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)

L’exemple prend le contosoBooks.xml fichier en tant qu’entrée.

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

Remarques

L’élément XPathNavigator est positionné sur le nouveau nœud à l’achèvement de la ReplaceSelf méthode et retourne true. Le XPathNavigator nœud n’est pas positionné sur le nouveau nœud après l’achèvement de la ReplaceSelf méthode lorsque l’entrée XML est Empty dans ce cas, celle-ci XPathNavigator est positionnée sur le nœud frère suivant ou le nœud parent s’il n’y a pas de nœud frère suivant au nœud remplacé et les ReplaceSelf retours false.

La ReplaceSelf méthode n’est valide que lorsque l’élément, le texte, l’instruction XPathNavigator de traitement ou le nœud de commentaire sont positionnés.
Si la chaîne de données XML n’est pas bien formée qu’une exception est levée et que le résultat de cette méthode équivaut à appeler DeleteSelf sur le nœud actuel.
Si la chaîne XML contient plusieurs nœuds, tous les nœuds sont ajoutés et sont XPathNavigator positionnés sur le premier nœud de la série de nœuds.
La ReplaceSelf méthode n’est pas équivalente à la DeleteSelf méthode.

S’applique à

ReplaceSelf(XPathNavigator)

Remplace le nœud actuel par le contenu de l’objet XPathNavigator spécifié.

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)

Paramètres

newNode: XPathNavigator

Objet XPathNavigator positionné sur le nouveau nœud.

Exceptions

ArgumentNullException

Le XPathNavigator paramètre d’objet est null.

InvalidOperationException

L’élément XPathNavigator n’est pas positionné sur un élément, un texte, une instruction de traitement ou un nœud de commentaire.

NotSupportedException

La XPathNavigator modification ne prend pas en charge la modification.

XmlException

Le contenu XML du XPathNavigator paramètre objet n’est pas bien formé.

Exemples

Dans l’exemple suivant, l’élément price du contosoBooks.xml fichier est remplacé par un nouvel pages élément.

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)

L’exemple prend le contosoBooks.xml fichier en tant qu’entrée.

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

Remarques

La ReplaceSelf méthode n’est valide que lorsque l’élément, le texte, l’instruction XPathNavigator de traitement ou le nœud de commentaire sont positionnés.
Si la chaîne de données XML n’est pas bien formée qu’une exception est levée et que le résultat de cette méthode équivaut à appeler DeleteSelf sur le nœud actuel.
Si la chaîne XML contient plusieurs nœuds, tous les nœuds sont ajoutés et sont XPathNavigator positionnés sur le premier nœud de la série de nœuds.
La ReplaceSelf méthode n’est pas équivalente à la DeleteSelf méthode.

S’applique à

ReplaceSelf(String)

Remplace le nœud actuel par le contenu de la chaîne spécifiée.

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)

Paramètres

newNode: String

Chaîne de données XML pour le nouveau nœud.

Exceptions

ArgumentNullException

Le paramètre de chaîne XML est null.

InvalidOperationException

L’élément XPathNavigator n’est pas positionné sur un élément, un texte, une instruction de traitement ou un nœud de commentaire.

NotSupportedException

La XPathNavigator modification ne prend pas en charge la modification.

XmlException

Le paramètre de chaîne XML n’est pas bien formé.

Exemples

Dans l’exemple suivant, l’élément price du contosoBooks.xml fichier est remplacé par un nouvel pages élément.

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)

L’exemple prend le contosoBooks.xml fichier en tant qu’entrée.

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

Remarques

La ReplaceSelf méthode n’est valide que lorsque l’élément, le texte, l’instruction XPathNavigator de traitement ou le nœud de commentaire sont positionnés.
Si la chaîne de données XML n’est pas bien formée qu’une exception est levée et que le résultat de cette méthode équivaut à appeler DeleteSelf sur le nœud actuel.
Si la chaîne XML contient plusieurs nœuds, tous les nœuds sont ajoutés et sont XPathNavigator positionnés sur le premier nœud de la série de nœuds.
La ReplaceSelf méthode n’est pas équivalente à la DeleteSelf méthode.

S’applique à

Commentaires

Cette page a-t-elle été utile ?