CompareInfo Clase

Definición

Espacio de nombres:
System.Globalization
Ensamblados:
mscorlib.dll, System.Globalization.dll
Ensamblados:
netstandard.dll, System.Runtime.dll
Ensamblado:
System.Globalization.dll
Ensamblado:
System.Runtime.dll
Ensamblado:
mscorlib.dll
Ensamblado:
netstandard.dll
Source:
CompareInfo.cs
Source:
CompareInfo.cs
Source:
CompareInfo.cs
Source:
CompareInfo.cs
Source:
CompareInfo.cs

Implementa un conjunto de métodos para comparaciones de cadenas que distinguen referencias culturales.

public ref class CompareInfo
public ref class CompareInfo sealed : System::Runtime::Serialization::IDeserializationCallback
public ref class CompareInfo : System::Runtime::Serialization::IDeserializationCallback
public class CompareInfo
public sealed class CompareInfo : System.Runtime.Serialization.IDeserializationCallback
public class CompareInfo : System.Runtime.Serialization.IDeserializationCallback
[System.Serializable]
public class CompareInfo : System.Runtime.Serialization.IDeserializationCallback
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class CompareInfo : System.Runtime.Serialization.IDeserializationCallback
type CompareInfo = class
type CompareInfo = class
    interface IDeserializationCallback
[<System.Serializable>]
type CompareInfo = class
    interface IDeserializationCallback
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type CompareInfo = class
    interface IDeserializationCallback
Public Class CompareInfo
Public NotInheritable Class CompareInfo
Implements IDeserializationCallback
Public Class CompareInfo
Implements IDeserializationCallback
Herencia
Object
CompareInfo
Atributos
SerializableAttribute ComVisibleAttribute
Implementaciones
IDeserializationCallback

Comentarios

Las convenciones para comparar y ordenar datos varían de una cultura a otra. Por ejemplo, el criterio de ordenación puede basarse en fonéticas o en la representación visual de caracteres. En los idiomas de Este de Asia, los caracteres se ordenan teniendo en cuenta los trazos y el radical de los ideogramas. El criterio de ordenación también depende del orden que se emplea en los distintos idiomas y referencias culturales para el alfabeto. Por ejemplo, el idioma danés tiene un carácter "Æ" que se ordena después de la "Z" en el alfabeto. Además, las comparaciones pueden distinguir mayúsculas de minúsculas o distinguir mayúsculas de minúsculas, y las reglas de mayúsculas y minúsculas también pueden diferir según la referencia cultural. La CompareInfo clase es responsable de mantener estos datos de comparación de cadenas sensibles a la cultura y de realizar operaciones de cadena sensibles a la cultura.

Normalmente, no es necesario crear instancias de un CompareInfo objeto directamente, ya que todas las operaciones de comparación de cadenas no ordinales usan implícitamente una, incluidas las llamadas al String.Compare método . Sin embargo, si desea recuperar un CompareInfo objeto, puede hacerlo de una de estas maneras:

  • Recuperando el valor de la propiedad CultureInfo.CompareInfopara una referencia cultural determinada.

  • Llamando al método estático con un nombre de referencia cultural GetCompareInfo. Esto permite el acceso enlazado en tiempo de ejecución a un objeto CompareInfo.

Valores de búsqueda omitidos

Los juegos de caracteres incluyen caracteres que se pueden pasar por alto, que son los caracteres que no se tienen en cuenta al realizar una comparación lingüística o en la que se tiene en cuenta la referencia cultural. Los métodos de comparación como IndexOf y LastIndexOf no tienen en cuenta esos caracteres cuando realizan una comparación sensible a las diferencias culturales. Entre los caracteres ignorables se incluyen:

  • String.Empty. Los métodos de comparación que distinguen referencias culturales siempre encontrarán una cadena vacía al principio (índice cero) de la cadena que se busca.

  • Carácter o cadena que consta de caracteres cuyos puntos de código no se consideran en la operación debido a las opciones de comparación. En particular, las opciones CompareOptions.IgnoreNonSpace y CompareOptions.IgnoreSymbols producen búsquedas en las que se ignoran los símbolos y los caracteres de combinación sin espaciado.

  • Cadena con puntos de código que no tienen ningún significado lingüístico. Por ejemplo, un guión flexible (U+00AD) siempre se omite en una comparación de cadenas que distingue la referencia cultural.

Consideraciones de seguridad

Si una decisión de seguridad depende de una comparación de cadenas o de un cambio de caso, debe usar la InvariantCulture propiedad para asegurarse de que el comportamiento sea coherente, independientemente de la configuración cultural del sistema operativo.

Note

Cuando sea posible, debe usar métodos de comparación de cadenas que tengan un parámetro de tipo CompareOptions para especificar el tipo de comparación esperado. Como regla general, use opciones lingüísticas (mediante la referencia cultural actual) para comparar cadenas mostradas en la interfaz de usuario y especificar Ordinal o OrdinalIgnoreCase para comparaciones de seguridad.

Example

  The following example shows how the <xref:System.Globalization.CompareInfo> object associated with a <xref:System.Globalization.CultureInfo> object affects string comparison.

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

Propiedades

Nombre Description
LCID

Obtiene el identificador de referencia cultural correctamente formado para el objeto actual CompareInfo.
Name

Obtiene el nombre de la referencia cultural utilizada para ordenar las operaciones por este CompareInfo objeto.
Version

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

Métodos

Nombre Description
Compare(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions)

Compara dos intervalos de caracteres de solo lectura.
Compare(String, Int32, Int32, String, Int32, Int32, CompareOptions)

Compara una sección de una cadena con una sección de otra cadena mediante el valor especificado CompareOptions .
Compare(String, Int32, Int32, String, Int32, Int32)

Compara una sección de una cadena con una sección de otra cadena.
Compare(String, Int32, String, Int32, CompareOptions)

Compara la sección final de una cadena con la sección final de otra cadena mediante el valor especificado CompareOptions .
Compare(String, Int32, String, Int32)

Compara la sección final de una cadena con la sección final de otra cadena.
Compare(String, String, CompareOptions)

Compara dos cadenas con el valor especificado CompareOptions .
Compare(String, String)

Compara dos cadenas.
Equals(Object)

Determina si el objeto especificado es igual al objeto actual CompareInfo .
GetCompareInfo(Int32, Assembly)

Inicializa un nuevo CompareInfo objeto asociado a la referencia cultural especificada y que usa métodos de comparación de cadenas en el especificado Assembly.
GetCompareInfo(Int32)

Inicializa un nuevo CompareInfo objeto asociado a la referencia cultural con el identificador especificado.
GetCompareInfo(String, Assembly)

Inicializa un nuevo CompareInfo objeto asociado a la referencia cultural especificada y que usa métodos de comparación de cadenas en el especificado Assembly.
GetCompareInfo(String)

Inicializa un nuevo CompareInfo objeto asociado a la referencia cultural con el nombre especificado.
GetHashCode()

Actúa como una función hash para el actual CompareInfo para algoritmos hash y estructuras de datos, como una tabla hash.
GetHashCode(ReadOnlySpan<Char>, CompareOptions)

Obtiene el código hash de un intervalo de caracteres basado en las opciones de comparación especificadas.
GetHashCode(String, CompareOptions)

Obtiene el código hash de una cadena basada en las opciones de comparación especificadas.
GetSortKey(ReadOnlySpan<Char>, Span<Byte>, CompareOptions)

Calcula una clave de ordenación para la entrada especificada.
GetSortKey(String, CompareOptions)

Obtiene un SortKey objeto para la cadena especificada utilizando el valor especificado CompareOptions .
GetSortKey(String)

Obtiene la clave de ordenación de la cadena especificada.
GetSortKeyLength(ReadOnlySpan<Char>, CompareOptions)

Obtiene el número total de bytes de clave de ordenación que se generarían a partir de la entrada especificada.
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
IndexOf(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions, Int32)

Busca la primera aparición de una subcadena dentro de una cadena de origen.
IndexOf(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions)

Busca la primera aparición de una subcadena dentro del intervalo de caracteres de solo lectura especificado.
IndexOf(ReadOnlySpan<Char>, Rune, CompareOptions)

Busca la primera aparición de un Rune objeto dentro del intervalo de caracteres de solo lectura especificado.
IndexOf(String, Char, CompareOptions)

Busca el carácter especificado y devuelve el índice de base cero de la primera aparición dentro de toda la cadena de origen mediante el valor especificado CompareOptions .
IndexOf(String, Char, Int32, CompareOptions)

Busca el carácter especificado y devuelve el índice de base cero de la primera aparición dentro de la sección de la cadena de origen que se extiende desde el índice especificado hasta el final de la cadena utilizando el valor especificado CompareOptions .
IndexOf(String, Char, Int32, Int32, CompareOptions)

Busca el carácter especificado y devuelve el índice de base cero de la primera aparición dentro de la sección de la cadena de origen que comienza en el índice especificado y contiene el número especificado de elementos utilizando el valor especificado CompareOptions .
IndexOf(String, Char, Int32, Int32)

Busca el carácter especificado y devuelve el índice de base cero de la primera aparición dentro de la sección de la cadena de origen que comienza en el índice especificado y contiene el número especificado de elementos.
IndexOf(String, Char, Int32)

Busca el carácter especificado y devuelve el índice de base cero de la primera aparición dentro de la sección de la cadena de origen que se extiende desde el índice especificado hasta el final de la cadena.
IndexOf(String, Char)

Busca el carácter especificado y devuelve el índice de base cero de la primera aparición dentro de toda la cadena de origen.
IndexOf(String, String, CompareOptions)

Busca la subcadena especificada y devuelve el índice de base cero de la primera aparición dentro de toda la cadena de origen mediante el valor especificado CompareOptions .
IndexOf(String, String, Int32, CompareOptions)

Busca la subcadena especificada y devuelve el índice de base cero de la primera aparición dentro de la sección de la cadena de origen que se extiende desde el índice especificado hasta el final de la cadena utilizando el valor especificado CompareOptions .
IndexOf(String, String, Int32, Int32, CompareOptions)

Busca la subcadena especificada y devuelve el índice de base cero de la primera aparición dentro de la sección de la cadena de origen que comienza en el índice especificado y contiene el número especificado de elementos utilizando el valor especificado CompareOptions .
IndexOf(String, String, Int32, Int32)

Busca la subcadena especificada y devuelve el índice de base cero de la primera aparición dentro de la sección de la cadena de origen que comienza en el índice especificado y contiene el número especificado de elementos.
IndexOf(String, String, Int32)

Busca la subcadena especificada y devuelve el índice de base cero de la primera aparición dentro de la sección de la cadena de origen que se extiende desde el índice especificado hasta el final de la cadena.
IndexOf(String, String)

Busca la subcadena especificada y devuelve el índice de base cero de la primera aparición dentro de toda la cadena de origen.
IsPrefix(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions, Int32)

Determina si una cadena comienza con un prefijo específico.
IsPrefix(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions)

Determina si un intervalo de caracteres de solo lectura comienza con un prefijo específico.
IsPrefix(String, String, CompareOptions)

Determina si la cadena de origen especificada comienza con el prefijo especificado mediante el valor especificado CompareOptions .
IsPrefix(String, String)

Determina si la cadena de origen especificada comienza con el prefijo especificado.
IsSortable(Char)

Indica si un carácter Unicode especificado se puede ordenar.
IsSortable(ReadOnlySpan<Char>)

Indica si se puede ordenar un intervalo de caracteres de solo lectura Unicode especificado.
IsSortable(Rune)

Indica si se puede ordenar un objeto especificado Rune .
IsSortable(String)

Indica si se puede ordenar una cadena Unicode especificada.
IsSuffix(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions, Int32)

Determina si una cadena termina con un sufijo específico.
IsSuffix(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions)

Determina si un intervalo de caracteres de solo lectura termina con un sufijo específico.
IsSuffix(String, String, CompareOptions)

Determina si la cadena de origen especificada termina con el sufijo especificado mediante el valor especificado CompareOptions .
IsSuffix(String, String)

Determina si la cadena de origen especificada termina con el sufijo especificado.
LastIndexOf(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions, Int32)

Busca la última aparición de una subcadena dentro de una cadena de origen.
LastIndexOf(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions)

Busca la última aparición de una subcadena dentro del intervalo de caracteres de solo lectura especificado.
LastIndexOf(ReadOnlySpan<Char>, Rune, CompareOptions)

Busca la última aparición de un objeto Rune dentro del intervalo de caracteres de solo lectura especificado.
LastIndexOf(String, Char, CompareOptions)

Busca el carácter especificado y devuelve el índice de base cero de la última aparición dentro de toda la cadena de origen mediante el valor especificado CompareOptions .
LastIndexOf(String, Char, Int32, CompareOptions)

Busca el carácter especificado y devuelve el índice de base cero de la última aparición dentro de la sección de la cadena de origen que se extiende desde el principio de la cadena hasta el índice especificado mediante el valor especificado CompareOptions .
LastIndexOf(String, Char, Int32, Int32, CompareOptions)

Busca el carácter especificado y devuelve el índice de base cero de la última aparición dentro de la sección de la cadena de origen que contiene el número especificado de elementos y termina en el índice especificado utilizando el valor especificado CompareOptions .
LastIndexOf(String, Char, Int32, Int32)

Busca el carácter especificado y devuelve el índice de base cero de la última aparición dentro de la sección de la cadena de origen que contiene el número especificado de elementos y termina en el índice especificado.
LastIndexOf(String, Char, Int32)

Busca el carácter especificado y devuelve el índice de base cero de la última aparición dentro de la sección de la cadena de origen que se extiende desde el principio de la cadena hasta el índice especificado.
LastIndexOf(String, Char)

Busca el carácter especificado y devuelve el índice de base cero de la última aparición dentro de toda la cadena de origen.
LastIndexOf(String, String, CompareOptions)

Busca la subcadena especificada y devuelve el índice de base cero de la última aparición dentro de toda la cadena de origen mediante el valor especificado CompareOptions .
LastIndexOf(String, String, Int32, CompareOptions)

Busca la subcadena especificada y devuelve el índice de base cero de la última aparición dentro de la sección de la cadena de origen que se extiende desde el principio de la cadena al índice especificado mediante el valor especificado CompareOptions .
LastIndexOf(String, String, Int32, Int32, CompareOptions)

Busca la subcadena especificada y devuelve el índice de base cero de la última aparición dentro de la sección de la cadena de origen que contiene el número especificado de elementos y termina en el índice especificado utilizando el valor especificado CompareOptions .
LastIndexOf(String, String, Int32, Int32)

Busca la subcadena especificada y devuelve el índice de base cero de la última aparición dentro de la sección de la cadena de origen que contiene el número especificado de elementos y termina en el índice especificado.
LastIndexOf(String, String, Int32)

Busca la subcadena especificada y devuelve el índice de base cero de la última aparición dentro de la sección de la cadena de origen que se extiende desde el principio de la cadena hasta el índice especificado.
LastIndexOf(String, String)

Busca la subcadena especificada y devuelve el índice de base cero de la última aparición dentro de toda la cadena de origen.
MemberwiseClone()

Crea una copia superficial del Objectactual.

(Heredado de Object)
ToString()

Devuelve una cadena que representa el objeto actual CompareInfo .

Implementaciones de interfaz explícitas

Nombre Description
IDeserializationCallback.OnDeserialization(Object)

Se ejecuta cuando se ha deserializado todo el gráfico de objetos.

Métodos de extensión

Nombre Description
GetStringComparer(CompareInfo, CompareOptions)

Devuelve un StringComparer objeto basado en las reglas de comparación de cadenas que distinguen referencias culturales de un objeto especificado CompareInfo .

Se aplica a

Consulte también