SortVersion Clase

Definición

Espacio de nombres:

System.Globalization

Ensamblados:

netstandard.dll, System.Runtime.dll

Source:

SortVersion.cs

Proporciona información sobre la versión de Unicode que se usa para comparar y ordenar cadenas.

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

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

type SortVersion = class
    interface IEquatable<SortVersion>

Public NotInheritable Class SortVersion
Implements IEquatable(Of SortVersion)

Herencia

Object

SortVersion

Implementaciones

IEquatable<SortVersion>

Comentarios

Comparación de cadenas y ordenación

Todas las versiones de .NET (Core) se basan en el sistema operativo subyacente al realizar comparaciones de cadenas. Por lo tanto, los resultados de una comparación de cadenas o el orden en que se ordenan las cadenas depende de la versión de Unicode usada por el sistema operativo al realizar la comparación. En Linux, macOS y Windows 10 y versiones posteriores, los componentes internacionales para bibliotecas Unicode proporcionan la implementación para las API de comparación y ordenación.

Uso de la clase SortVersion

La SortVersion clase proporciona información sobre la versión Unicode usada por .NET para la comparación y ordenación de cadenas. Permite a los desarrolladores escribir aplicaciones que puedan detectar y controlar correctamente los cambios en la versión de Unicode que se usa para comparar y ordenar las cadenas de una aplicación.

Puede crear instancias de un SortVersion objeto de dos maneras:

• Al llamar al constructor SortVersion, que instancia un nuevo objeto SortVersion basado en un número de versión y un identificador de ordenación. Este constructor es más útil al volver a crear un SortVersion objeto a partir de datos guardados.
• Recuperando el valor de la propiedad CompareInfo.Version. Esta propiedad proporciona información sobre la versión Unicode que usa la implementación de .NET en la que se ejecuta la aplicación.

La SortVersion clase tiene dos propiedades, FullVersion y SortId, que indican la versión Unicode y la referencia cultural específica usada para la comparación de cadenas. La FullVersion propiedad es un valor numérico arbitrario que refleja la versión Unicode utilizada para la comparación de cadenas, y la SortId propiedad es un valor arbitrario que refleja la cultura Guid, cuyas convenciones se usan para la comparación de cadenas. Los valores de estas dos propiedades son importantes solo cuando se comparan dos SortVersion objetos mediante el Equals método , el Equality operador o el Inequality operador .

Normalmente, se usa un objeto SortVersion al guardar o recuperar alguna forma de datos de cadena ordenados y confidenciales de referencia cultural, como índices o cadenas literales. Esto requiere los pasos siguientes:

1. Cuando se guardan los datos de cadena ordenados, también se guardan los valores de propiedad FullVersion y SortId .

2. Cuando se recuperan los datos de cadena ordenados, puede volver a crear el SortVersion objeto utilizado para ordenar las cadenas llamando al SortVersion constructor .

3. Este objeto recién creado SortVersion se compara con un SortVersion objeto que refleja la cultura cuyas convenciones se usan para ordenar los datos de texto.

4. Si los dos SortVersion objetos no son iguales, los datos de cadena se deben reordenar.

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

Constructores

Nombre	Description
SortVersion(Int32, Guid)	Crea una nueva instancia de la SortVersion clase .

Propiedades

Nombre	Description
FullVersion	Obtiene el número de versión completo del SortVersion objeto .
SortId	Obtiene un identificador único global para este SortVersion objeto.

Métodos

Nombre	Description
Equals(Object)	Devuelve un valor que indica si esta SortVersion instancia es igual a un objeto especificado.
Equals(SortVersion)	Devuelve un valor que indica si esta SortVersion instancia es igual a un objeto especificado SortVersion .
GetHashCode()	Devuelve un código hash para esta instancia.
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Operadores

Nombre	Description
Equality(SortVersion, SortVersion)	Indica si dos SortVersion instancias son iguales.
Inequality(SortVersion, SortVersion)	Indica si dos SortVersion instancias no son iguales.

Consulte también

• Version