SortVersion Classe

Definição

public ref class SortVersion sealed : IEquatable<System::Globalization::SortVersion ^>

public sealed class SortVersion : IEquatable<System.Globalization.SortVersion>

[System.Serializable]
public sealed class SortVersion : IEquatable<System.Globalization.SortVersion>

type SortVersion = class
    interface IEquatable<SortVersion>

[<System.Serializable>]
type SortVersion = class
    interface IEquatable<SortVersion>

Public NotInheritable Class SortVersion
Implements IEquatable(Of SortVersion)

Herança

Object

SortVersion

Atributos

SerializableAttribute

Implementações

IEquatable<SortVersion>

Observações

Ordenação e comparação de cadeias

Todas as versões do .NET (Core) dependem do sistema operacional subjacente ao executar comparações de cadeia de caracteres. Portanto, os resultados de uma comparação de cadeia de caracteres ou a ordem na qual as cadeias de caracteres são classificadas dependem da versão do Unicode usada pelo sistema operacional ao executar a comparação. No Linux, macOS e Windows 10 e versões posteriores, as bibliotecas International Components for Unicode fornecem a implementação para APIs de comparação e classificação.

Use a classe SortVersion

A SortVersion classe fornece informações sobre a versão Unicode usada pelo .NET para comparação e ordenação de cadeia de caracteres. Ele permite que os desenvolvedores escrevam aplicativos que podem detetar e manipular com êxito alterações na versão do Unicode que é usada para comparar e classificar as cadeias de caracteres de um aplicativo.

Você pode instanciar um SortVersion objeto de duas maneiras:

• Ao chamar o construtor SortVersion, que instancia um novo objeto SortVersion com base num número de versão e um ID de ordenação. Este construtor é mais útil ao recriar um SortVersion objeto a partir de dados salvos.
• Recuperando o valor da propriedade CompareInfo.Version. Esta propriedade fornece informações sobre a versão Unicode usada pela implementação .NET na qual o aplicativo está sendo executado.

A SortVersion classe tem duas propriedades FullVersion e SortId, que indicam a versão Unicode e a cultura específica usada para comparação de cadeia de caracteres. A propriedade FullVersion é um valor numérico arbitrário que reflete a versão Unicode, usada para comparação de sequências de caracteres, e a propriedade SortId é um Guid arbitrário que reflete a cultura cujas convenções são usadas para comparação de sequências de caracteres. Os valores dessas duas propriedades são importantes somente quando você compara dois SortVersion objetos usando o Equals método, o Equality operador ou o Inequality operador.

Normalmente, você usa um SortVersion objeto ao salvar ou recuperar alguma forma de dados de cadeia de caracteres ordenada e sensíveis à cultura, como índices ou as próprias cadeias de caracteres literais. Isso requer as seguintes etapas:

1. Quando uma cadeia de caracteres ordenada é salva, os valores das propriedades FullVersion e SortId também são salvos.

2. Quando os dados de cadeia de caracteres ordenados são recuperados, você pode recriar o SortVersion objeto usado para ordenar as cadeias de caracteres chamando o SortVersion construtor.

3. Esse objeto recém-instanciado SortVersion é comparado com um SortVersion objeto que reflete a cultura cujas convenções são usadas para ordenar os dados da cadeia de caracteres.

4. Se os dois SortVersion objetos não forem iguais, os dados da cadeia de caracteres deverão ser reordenados.

Example

  The following example contains a portion of the source code from an application that uses the <xref:System.Globalization.SortVersion> class to ensure that the native names of <xref:System.Globalization.RegionInfo> objects are ordered appropriately for the current system and current culture. It uses the <xref:System.IO.BinaryReader> and <xref:System.IO.BinaryWriter> objects to store and retrieve ordered data from a data file named `Regions.dat` rather than retrieving and ordering data each time the application is run. The example first checks to determine whether the data file exists. If it does not, it creates the data and sets the `reindex` flag, which indicates that the data must be resorted and saved again. Otherwise, it retrieves the data and compares the saved <xref:System.Globalization.SortVersion> object with the <xref:System.Globalization.SortVersion> object for the current culture on the current system. If they aren't equal, or if the `reindex` flag had been set previously, it resorts to the <xref:System.Globalization.RegionInfo> data.

  :::code language="csharp" source="~/snippets/csharp/System.Globalization/SortVersion/Overview/example1.cs" id="Snippet1":::
  :::code language="vb" source="~/snippets/visualbasic/System.Globalization/SortVersion/Overview/example1.vb" id="Snippet1":::

Ver também

• Version