XPathExpression.SetContext Metoda

Reference

Definice

Obor názvů:: System.Xml.XPath

Sestavení:: System.Xml.ReaderWriter.dll

Sestavení:: System.Xml.XPath.dll

Sestavení:: System.Xml.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Při přepsání v odvozené třídě určuje IXmlNamespaceResolver objekt, který se má použít pro rozlišení oboru názvů.

Přetížení

SetContext(IXmlNamespaceResolver)	Při přepsání v odvozené třídě určuje IXmlNamespaceResolver objekt, který se má použít pro rozlišení oboru názvů.
SetContext(XmlNamespaceManager)	Při přepsání v odvozené třídě určuje XmlNamespaceManager objekt, který se má použít pro rozlišení oboru názvů.

SetContext(IXmlNamespaceResolver)

Při přepsání v odvozené třídě určuje IXmlNamespaceResolver objekt, který se má použít pro rozlišení oboru názvů.

public:
 abstract void SetContext(System::Xml::IXmlNamespaceResolver ^ nsResolver);

public abstract void SetContext (System.Xml.IXmlNamespaceResolver? nsResolver);

public abstract void SetContext (System.Xml.IXmlNamespaceResolver nsResolver);

abstract member SetContext : System.Xml.IXmlNamespaceResolver -> unit

Public MustOverride Sub SetContext (nsResolver As IXmlNamespaceResolver)

Parametry

nsResolver: IXmlNamespaceResolver

Objekt, který implementuje IXmlNamespaceResolver rozhraní pro rozlišení oboru názvů.

Výjimky

XPathException

Parametr objektu IXmlNamespaceResolver není odvozen z IXmlNamespaceResolver.

Příklady

Následující příklad ukazuje, jak pomocí návratového typu XPath určit, jak zpracovat výraz XPath a jak použít metodu SetContext XmlNamespaceManager k poskytnutí objektu pro překlad oboru názvů.

public ref class Sample
{
public:
   static void Evaluate( XPathExpression^ expr, XPathNavigator^ nav )
   {
      XPathNodeIterator^ i = nav->Select(expr);
      switch ( expr->ReturnType )
      {
         case XPathResultType::Number:
            Console::WriteLine( nav->Evaluate( expr ) );
            break;

         case XPathResultType::NodeSet:
            while ( i->MoveNext() )
                        Console::WriteLine( i->Current );
            break;

         case XPathResultType::Boolean:
            if ( *safe_cast<bool^>(nav->Evaluate( expr )) )
                        Console::WriteLine( "True!" );
            break;

         case XPathResultType::String:
            Console::WriteLine( nav->Evaluate( expr ) );
            break;
      }
   }

};

int main()
{
   XPathDocument^ doc = gcnew XPathDocument( "contosoBooks.xml" );
   XPathNavigator^ nav = doc->CreateNavigator();
   XPathExpression^ expr1 = nav->Compile( ".//price/text()*10" ); // Returns a number.

   XPathExpression^ expr2 = nav->Compile( "bookstore/book/price" ); // Returns a nodeset.

   Sample^ MySample = gcnew Sample;
   MySample->Evaluate( expr1, nav );
   MySample->Evaluate( expr2, nav );
}

using System;
using System.Xml;
using System.Xml.XPath;

public class XPathExpressionExample
{
    public static void Main()
    {
        XPathDocument document = new XPathDocument("contosoBooks.xml");
        XPathNavigator navigator = document.CreateNavigator();

        XPathExpression expression1 = XPathExpression.Compile(".//bk:price/text()*10"); // Returns a number.
        XPathExpression expression2 = XPathExpression.Compile("bk:bookstore/bk:book/bk:price"); // Returns a nodeset.

        XmlNamespaceManager manager = new XmlNamespaceManager(navigator.NameTable);
        manager.AddNamespace("bk", "http://www.contoso.com/books");

        expression1.SetContext(manager);
        expression2.SetContext(manager);

        Evaluate(expression1, navigator);
        Evaluate(expression2, navigator);
    }

    public static void Evaluate(XPathExpression expression, XPathNavigator navigator)
    {
        switch (expression.ReturnType)
        {
            case XPathResultType.Number:
                Console.WriteLine(navigator.Evaluate(expression));
                break;

            case XPathResultType.NodeSet:
                XPathNodeIterator nodes = navigator.Select(expression);
                while (nodes.MoveNext())
                {
                    Console.WriteLine(nodes.Current.ToString());
                }
                break;

            case XPathResultType.Boolean:
                if ((bool)navigator.Evaluate(expression))
                    Console.WriteLine("True!");
                break;

            case XPathResultType.String:
                Console.WriteLine(navigator.Evaluate(expression));
                break;
        }
    }
}

Imports System.Xml
Imports System.Xml.XPath

Public Class XPathExpressionExample

    Public Shared Sub Main()
        Dim document As XPathDocument = New XPathDocument("contosoBooks.xml")
        Dim navigator As XPathNavigator = document.CreateNavigator()

        Dim expression1 As XPathExpression = XPathExpression.Compile(".//bk:price/text()*10")  ' Returns a number.
        Dim expression2 As XPathExpression = XPathExpression.Compile("bk:bookstore/bk:book/bk:price")  ' Returns a nodeset.

        Dim manager As XmlNamespaceManager = New XmlNamespaceManager(navigator.NameTable)
        manager.AddNamespace("bk", "http://www.contoso.com/books")

        expression1.SetContext(manager)
        expression2.SetContext(manager)

        Evaluate(expression1, navigator)
        Evaluate(expression2, navigator)

    End Sub

    Public Shared Sub Evaluate(ByVal expression As XPathExpression, ByVal navigator As XPathNavigator)

        Select Case expression.ReturnType
            Case XPathResultType.Number
                Console.WriteLine(navigator.Evaluate(expression))
                Exit Sub

            Case XPathResultType.NodeSet
                Dim nodes As XPathNodeIterator = navigator.Select(expression)
                While nodes.MoveNext()
                    Console.WriteLine(nodes.Current.ToString())
                End While

            Case XPathResultType.Boolean
                If CType(navigator.Evaluate(expression), Boolean) Then
                    Console.WriteLine("True!")
                End If

            Case XPathResultType.String
                Console.WriteLine(navigator.Evaluate(expression))
        End Select

    End Sub
End Class

Příklad vezme contosoBooks.xml soubor jako vstup.

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

Poznámky

Překlad oboru názvů se podporuje pomocí tříd, které implementují IXmlNamespaceResolver rozhraní, například třídu XmlNamespaceManager . Ukládá XmlNamespaceManager mapování předpony a oboru názvů Uniform Resource Identifier (URI). XPathExpression Pokud vyžaduje rozlišení oboru názvů, musí být dvojice identifikátorů URI předpony a oboru názvů přidána do objektu, jako XmlNamespaceManager je třída, která implementuje IXmlNamespaceResolver rozhraní, a SetContext metoda musí být volána k určení IXmlNamespaceResolver objektu rozhraní, který se má použít pro překlad oboru názvů.

Při používání SetContext metody je potřeba vzít v úvahu následující důležité poznámky.

XPathExpression Pokud neobsahuje předponu, předpokládá se, že identifikátor URI oboru názvů je prázdný obor názvů. Pokud váš XML obsahuje výchozí obor názvů, musíte použít metodu SetContext a zadat objekt, který obsahuje předponu a identifikátor URI oboru názvů pro zpracování výchozího oboru názvů.
Při vytváření XPathExpression objektu IXmlNamespaceResolver Compile můžete také zadat objekt rozhraní pro překlad oboru názvů do metody.
SetContext přijímá XsltContext jako překladač oboru názvů, takže můžete implementovat vlastní kontext a používat funkce a proměnné na IXsltContextFunction základě a IXsltContextVariable. Výraz XPath je spustí. Další informace najdete v tématu Uživatelem definované funkce a proměnné.

Viz také

Platí pro

SetContext(XmlNamespaceManager)

Při přepsání v odvozené třídě určuje XmlNamespaceManager objekt, který se má použít pro rozlišení oboru názvů.

public:
 abstract void SetContext(System::Xml::XmlNamespaceManager ^ nsManager);

public abstract void SetContext (System.Xml.XmlNamespaceManager nsManager);

abstract member SetContext : System.Xml.XmlNamespaceManager -> unit

Public MustOverride Sub SetContext (nsManager As XmlNamespaceManager)

Parametry

nsManager: XmlNamespaceManager

Objekt XmlNamespaceManager , který se má použít pro překlad oboru názvů.

Výjimky

XPathException

Parametr objektu XmlNamespaceManager XmlNamespaceManager není odvozen z třídy.

Příklady

public ref class Sample
{
public:
   static void Evaluate( XPathExpression^ expr, XPathNavigator^ nav )
   {
      XPathNodeIterator^ i = nav->Select(expr);
      switch ( expr->ReturnType )
      {
         case XPathResultType::Number:
            Console::WriteLine( nav->Evaluate( expr ) );
            break;

         case XPathResultType::NodeSet:
            while ( i->MoveNext() )
                        Console::WriteLine( i->Current );
            break;

         case XPathResultType::Boolean:
            if ( *safe_cast<bool^>(nav->Evaluate( expr )) )
                        Console::WriteLine( "True!" );
            break;

         case XPathResultType::String:
            Console::WriteLine( nav->Evaluate( expr ) );
            break;
      }
   }

};

int main()
{
   XPathDocument^ doc = gcnew XPathDocument( "contosoBooks.xml" );
   XPathNavigator^ nav = doc->CreateNavigator();
   XPathExpression^ expr1 = nav->Compile( ".//price/text()*10" ); // Returns a number.

   XPathExpression^ expr2 = nav->Compile( "bookstore/book/price" ); // Returns a nodeset.

   Sample^ MySample = gcnew Sample;
   MySample->Evaluate( expr1, nav );
   MySample->Evaluate( expr2, nav );
}

using System;
using System.Xml;
using System.Xml.XPath;

public class XPathExpressionExample
{
    public static void Main()
    {
        XPathDocument document = new XPathDocument("contosoBooks.xml");
        XPathNavigator navigator = document.CreateNavigator();

        XPathExpression expression1 = XPathExpression.Compile(".//bk:price/text()*10"); // Returns a number.
        XPathExpression expression2 = XPathExpression.Compile("bk:bookstore/bk:book/bk:price"); // Returns a nodeset.

        XmlNamespaceManager manager = new XmlNamespaceManager(navigator.NameTable);
        manager.AddNamespace("bk", "http://www.contoso.com/books");

        expression1.SetContext(manager);
        expression2.SetContext(manager);

        Evaluate(expression1, navigator);
        Evaluate(expression2, navigator);
    }

    public static void Evaluate(XPathExpression expression, XPathNavigator navigator)
    {
        switch (expression.ReturnType)
        {
            case XPathResultType.Number:
                Console.WriteLine(navigator.Evaluate(expression));
                break;

            case XPathResultType.NodeSet:
                XPathNodeIterator nodes = navigator.Select(expression);
                while (nodes.MoveNext())
                {
                    Console.WriteLine(nodes.Current.ToString());
                }
                break;

            case XPathResultType.Boolean:
                if ((bool)navigator.Evaluate(expression))
                    Console.WriteLine("True!");
                break;

            case XPathResultType.String:
                Console.WriteLine(navigator.Evaluate(expression));
                break;
        }
    }
}

Imports System.Xml
Imports System.Xml.XPath

Public Class XPathExpressionExample

    Public Shared Sub Main()
        Dim document As XPathDocument = New XPathDocument("contosoBooks.xml")
        Dim navigator As XPathNavigator = document.CreateNavigator()

        Dim expression1 As XPathExpression = XPathExpression.Compile(".//bk:price/text()*10")  ' Returns a number.
        Dim expression2 As XPathExpression = XPathExpression.Compile("bk:bookstore/bk:book/bk:price")  ' Returns a nodeset.

        Dim manager As XmlNamespaceManager = New XmlNamespaceManager(navigator.NameTable)
        manager.AddNamespace("bk", "http://www.contoso.com/books")

        expression1.SetContext(manager)
        expression2.SetContext(manager)

        Evaluate(expression1, navigator)
        Evaluate(expression2, navigator)

    End Sub

    Public Shared Sub Evaluate(ByVal expression As XPathExpression, ByVal navigator As XPathNavigator)

        Select Case expression.ReturnType
            Case XPathResultType.Number
                Console.WriteLine(navigator.Evaluate(expression))
                Exit Sub

            Case XPathResultType.NodeSet
                Dim nodes As XPathNodeIterator = navigator.Select(expression)
                While nodes.MoveNext()
                    Console.WriteLine(nodes.Current.ToString())
                End While

            Case XPathResultType.Boolean
                If CType(navigator.Evaluate(expression), Boolean) Then
                    Console.WriteLine("True!")
                End If

            Case XPathResultType.String
                Console.WriteLine(navigator.Evaluate(expression))
        End Select

    End Sub
End Class

Příklad vezme contosoBooks.xml soubor jako vstup.

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

Poznámky

Překlad oboru názvů se podporuje pomocí XmlNamespaceManager třídy, která ukládá mapování identifikátoru URI (Prefix) a oboru názvů Uniform Resource Identifier (URI). XPathExpression Pokud vyžaduje překlad oboru názvů, musí se do objektu přidat XmlNamespaceManager pár identifikátorů URI předpony a identifikátor URI oboru názvů a SetContext metoda musí být volána k určení objektuXmlNamespaceManager, který se má použít pro rozlišení oboru názvů.

Při používání SetContext metody je potřeba vzít v úvahu následující důležité poznámky.

XPathExpression Pokud neobsahuje předponu, předpokládá se, že identifikátor URI oboru názvů je prázdný obor názvů. Pokud váš XML obsahuje výchozí obor názvů, musíte použít metodu SetContext a zadat XmlNamespaceManager objekt, který obsahuje předponu a identifikátor URI oboru názvů pro zpracování výchozího oboru názvů.
Při vytváření XPathExpression objektu IXmlNamespaceResolver Compile můžete také zadat objekt pro překlad oboru názvů do metody.
SetContext přijímá XsltContext jako překladač oboru názvů, takže můžete implementovat vlastní kontext a používat funkce a proměnné na IXsltContextFunction základě a IXsltContextVariable. Výraz XPath je spustí. Další informace najdete v tématu Uživatelem definované funkce a proměnné.

Viz také

Platí pro

XPathExpression.SetContext Metoda

Definice

Přetížení

SetContext(IXmlNamespaceResolver)

Parametry

Výjimky

Příklady

Poznámky

Viz také

Platí pro

SetContext(XmlNamespaceManager)

Parametry

Výjimky

Příklady

Poznámky

Viz také

Platí pro

Další materiály