XPathExpression.AddSort 方法

参考

定义

命名空间:: System.Xml.XPath

程序集:: System.Xml.ReaderWriter.dll

程序集:: System.Xml.XPath.dll

程序集:: System.Xml.dll

程序集:: netstandard.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

当在派生类中重写时，对 XPath 表达式选择的节点排序。

重载

AddSort(Object, IComparer)	当在派生类中重写时，按指定的 IComparer 对象对 XPath 表达式选择的节点排序。
AddSort(Object, XmlSortOrder, XmlCaseOrder, String, XmlDataType)	当在派生类中被重写时，根据所提供的参数对 XPath 表达式所选的节点进行排序。

AddSort(Object, IComparer)

Source:: XPathExpr.cs

Source:: XPathExpr.cs

Source:: XPathExpr.cs

当在派生类中重写时，按指定的 IComparer 对象对 XPath 表达式选择的节点排序。

public:
 abstract void AddSort(System::Object ^ expr, System::Collections::IComparer ^ comparer);

public abstract void AddSort (object expr, System.Collections.IComparer comparer);

abstract member AddSort : obj * System.Collections.IComparer -> unit

Public MustOverride Sub AddSort (expr As Object, comparer As IComparer)

参数

expr: Object

一个表示排序关键字的对象。这可以是节点的 string 值，还可以是具有已编译 XPath 表达式的 XPathExpression 对象。

comparer: IComparer

IComparer 对象，为比较两个对象的等效性提供特定的数据类型比较。

例外

XPathException

XPathExpression 或排序关键字包括前缀，并且未提供 XmlNamespaceManager 或未在所提供的 XmlNamespaceManager 中找到该前缀。

注解

方法 AddSort 使用户能够按其数据类型而不是字符串或数字对对象进行排序。对象 IComparer 提供方法的实现， Compare 该方法支持对用户定义的类进行排序。

在以下示例中，书籍按 ISBN 编号排序，其中 isbn 是实现接口的对象 IComparer 。

Dim expression As XPathExpression = navigator.Compile("bookstore/book")  
Dim isbn As ISBN = New ISBN()  
expression.AddSort("@ISBN", (IComparer)isbn)

XPathExpression expression = navigator.Compile("bookstore/book");  
ISBN isbn = new ISBN();  
expression.AddSort("@ISBN", (IComparer)isbn);

下面是使用 AddSort 方法时要考虑的重要注意事项。

排序的添加顺序提供排序键顺序。
XPathExpression如果或排序键需要命名空间解析，则必须使用 SetContext 方法为命名空间解析提供 XmlNamespaceManager 。
XPathExpression如果不包含前缀，则假定命名空间统一资源标识符 (URI) 为空命名空间。如果 XML 包含默认命名空间，则仍 SetContext 必须使用方法并提供一个 XmlNamespaceManager 包含前缀和命名空间 URI 的来处理默认命名空间。

另请参阅

适用于

AddSort(Object, XmlSortOrder, XmlCaseOrder, String, XmlDataType)

Source:: XPathExpr.cs

Source:: XPathExpr.cs

Source:: XPathExpr.cs

当在派生类中被重写时，根据所提供的参数对 XPath 表达式所选的节点进行排序。

public:
 abstract void AddSort(System::Object ^ expr, System::Xml::XPath::XmlSortOrder order, System::Xml::XPath::XmlCaseOrder caseOrder, System::String ^ lang, System::Xml::XPath::XmlDataType dataType);

public abstract void AddSort (object expr, System.Xml.XPath.XmlSortOrder order, System.Xml.XPath.XmlCaseOrder caseOrder, string lang, System.Xml.XPath.XmlDataType dataType);

abstract member AddSort : obj * System.Xml.XPath.XmlSortOrder * System.Xml.XPath.XmlCaseOrder * string * System.Xml.XPath.XmlDataType -> unit

Public MustOverride Sub AddSort (expr As Object, order As XmlSortOrder, caseOrder As XmlCaseOrder, lang As String, dataType As XmlDataType)

参数

expr: Object

一个表示排序关键字的对象。这可以是节点的 string 值，还可以是具有已编译 XPath 表达式的 XPathExpression 对象。

order: XmlSortOrder

一个 XmlSortOrder 值，它指示排序顺序。

caseOrder: XmlCaseOrder

一个 XmlCaseOrder 值，它指示大写字母和小写字母的排序方式。

lang: String

要用于比较的语言。使用 CultureInfo 类，该类可传递到适用于语言类型（例如，“us-en”表示美国英语）的 Compare 方法。如果指定了空的字符串，则使用系统环境来确定 CultureInfo。

dataType: XmlDataType

一个 XmlDataType 值，它指示数据类型的排序顺序。

例外

XPathException

XPathExpression 或排序关键字包括前缀，并且未提供 XmlNamespaceManager 或未在所提供的 XmlNamespaceManager 中找到该前缀。

示例

以下示例演示如何按价格按降序对书籍文档进行排序。

Imports System.Xml
Imports System.Xml.XPath

Module Module1

    Sub Main()
        Dim doc As New XPathDocument("contosoBooks.xml")
        Dim nav As XPathNavigator = doc.CreateNavigator()

        Dim expr As XPathExpression
        expr = nav.Compile("/bookstore/book")

        expr.AddSort("price", XmlSortOrder.Descending, _
                          XmlCaseOrder.None, "", XmlDataType.Number)

        Dim iterator As XPathNodeIterator = nav.Select(expr)
        Do While iterator.MoveNext()

            If (iterator.Current.HasChildren()) Then
                Dim childIter As XPathNodeIterator = _
                iterator.Current.SelectChildren(XPathNodeType.Element)
                Do While childIter.MoveNext()
                    Console.WriteLine(childIter.Current.Value)
                Loop

            End If
        Loop

    End Sub

End Module

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

namespace SortBooks
{
    class Program
    {
        static void Main(string[] args)
        {
            XPathDocument doc = new XPathDocument("contosoBooks.xml");
            XPathNavigator nav = doc.CreateNavigator();

            XPathExpression expr;
            expr = nav.Compile("/bookstore/book");

            expr.AddSort("price", XmlSortOrder.Descending,
                           XmlCaseOrder.None, "", XmlDataType.Number);

            XPathNodeIterator iterator = nav.Select(expr);
            while (iterator.MoveNext())
            {
                if (iterator.Current.HasChildren)
                {
                    XPathNodeIterator childIter =
              iterator.Current.SelectChildren(XPathNodeType.Element);
                    while (childIter.MoveNext())
                    {
                        Console.WriteLine(childIter.Current.Value);
                    }
                }
            }
        }
    }
}

该示例使用 books.xml 文件作为输入。

<?xml version="1.0" encoding="utf-8" ?>   
<bookstore>  
    <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>

注解

排序的添加顺序提供排序键顺序。
XPathExpression如果或排序键需要命名空间解析，则必须使用 SetContext 方法为命名空间解析提供 XmlNamespaceManager 。
XPathExpression如果不包含前缀，则假定命名空间统一资源标识符 (URI) 为空命名空间。如果 XML 包含默认命名空间，则仍 SetContext 必须使用方法并提供一个 XmlNamespaceManager 包含前缀和命名空间 URI 的来处理默认命名空间。

另请参阅

适用于

通过

XPathExpression.AddSort 方法

定义

重载

AddSort(Object, IComparer)

参数

例外

注解

另请参阅

适用于

AddSort(Object, XmlSortOrder, XmlCaseOrder, String, XmlDataType)

参数

例外

示例

注解

另请参阅

适用于

其他资源