XPathExpression.AddSort Метод

Исходный код:

XPathExpr.cs

Исходный код:

XPathExpr.cs

Исходный код:

XPathExpr.cs

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)

Параметры

Исключения

Комментарии

Метод 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 пространства имен для обработки пространства имен по умолчанию.

См. также раздел

• IComparer
• XmlNamespaceManager
• Compare(Object, Object)
• SetContext(XmlNamespaceManager)

Исходный код:

XPathExpr.cs

Исходный код:

XPathExpr.cs

Исходный код:

XPathExpr.cs

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)

Параметры

Исключения

Примеры

В следующем примере показано, как отсортировать документ книги по цене в порядке убывания.

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 пространства имен для обработки пространства имен по умолчанию.

См. также раздел

• XmlSortOrder
• XmlCaseOrder
• XmlDataType
• XmlNamespaceManager
• CultureInfo
• Compare
• SetContext(XmlNamespaceManager)