XPathExpression.AddSort Метод
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
При переопределении в производном классе выполняется сортировка узлов, выбранных выражением XPath.
AddSort(Object, IComparer) |
При переопределении в производном классе выполняется сортировка узлов, выбранных выражением XPath, согласно заданному объекту IComparer. |
AddSort(Object, XmlSortOrder, XmlCaseOrder, String, XmlDataType) |
При переопределении в производном классе выполняет сортировку узлов, выбранных выражением XPath, согласно указанным параметрам. |
- Исходный код:
- XPathExpr.cs
- Исходный код:
- XPathExpr.cs
- Исходный код:
- XPathExpr.cs
При переопределении в производном классе выполняется сортировка узлов, выбранных выражением XPath, согласно заданному объекту IComparer.
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
узла или объект XPathExpression со скомпилированным выражением XPath.
- comparer
- IComparer
Объект IComparer, предоставляющий сравнения определенных типов данных для сравнения двух объектов на предмет эквивалентности.
Исключения
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 пространства имен для обработки пространства имен по умолчанию.
См. также раздел
Применяется к
.NET 9 и другие версии
Продукт | Версии |
---|---|
.NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 2.0, 2.1 |
- Исходный код:
- XPathExpr.cs
- Исходный код:
- XPathExpr.cs
- Исходный код:
- 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
узла или объект XPathExpression со скомпилированным выражением XPath.
- order
- XmlSortOrder
Значение XmlSortOrder, указывающее порядок сортировки.
- caseOrder
- XmlCaseOrder
Значение XmlCaseOrder, указывающее, как должны сортироваться прописные и строчные буквы.
- lang
- String
Язык, используемый для сравнения. Использует класс CultureInfo, который может передаваться в метод Compare для типов языков, например, "us-en" для английского языка (американская версия). Если задана пустая строка, для определения CultureInfo используется среда системы.
- dataType
- XmlDataType
Значение XmlDataType, указывающее порядок сортировки для типа данных.
Исключения
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 пространства имен для обработки пространства имен по умолчанию.
См. также раздел
- XmlSortOrder
- XmlCaseOrder
- XmlDataType
- XmlNamespaceManager
- CultureInfo
- Compare
- SetContext(XmlNamespaceManager)
Применяется к
.NET 9 и другие версии
Продукт | Версии |
---|---|
.NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 2.0, 2.1 |
Отзыв о .NET
.NET — это проект с открытым исходным кодом. Выберите ссылку, чтобы оставить отзыв: