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>

Comentários

Classificação e comparação de cadeia de caracteres

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 da 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, os Componentes Internacionais para bibliotecas Unicode fornecem a implementação de APIs de comparação e classificação.

Usar a classe SortVersion

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

Você pode criar uma instância de um SortVersion objeto de duas maneiras:

• Chamando o construtor SortVersion, que instancia um novo objeto SortVersion com base em um número de versão e ID de classificação. Esse construtor é mais útil ao recriar um SortVersion objeto de dados salvos.
• Recuperando o valor da propriedade CompareInfo.Version. Essa propriedade fornece informações sobre a versão Unicode usada pela implementação do .NET na qual o aplicativo está em execução.

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 FullVersion propriedade é um valor numérico arbitrário que reflete a versão Unicode usada para comparação de cadeia de caracteres, e a SortId propriedade é uma arbitrária Guid que reflete a cultura cujas convenções são usadas para comparação de cadeia 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 ordenados e sensíveis à cultura, como índices ou as próprias cadeias de caracteres literais. Isso requer as seguintes etapas:

1. Quando os dados de cadeia de caracteres ordenados são salvos, 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.

Exemplo

  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":::

Confira também

• Version