Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase CompareInfo

 

Publicado: octubre de 2016

Implementa un conjunto de métodos para la comparación de cadenas que tienen en cuenta la referencia cultural.

Espacio de nombres:   System.Globalization
Ensamblado:  mscorlib (en mscorlib.dll)

System.Object
  System.Globalization.CompareInfo

[SerializableAttribute]
[ComVisibleAttribute(true)]
public class CompareInfo : IDeserializationCallback

NombreDescripción
System_CAPS_pubpropertyLCID

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

System_CAPS_pubpropertyName

Obtiene el nombre de la referencia cultural utilizada por este objeto CompareInfo para las operaciones de ordenación.

System_CAPS_pubpropertyVersion

Obtiene información sobre la versión de Unicode utilizada para comparar y ordenar cadenas.

NombreDescripción
System_CAPS_pubmethodCompare(String, Int32, Int32, String, Int32, Int32)

Compara una sección de una cadena con la de otra cadena.

System_CAPS_pubmethodCompare(String, Int32, Int32, String, Int32, Int32, CompareOptions)

Compara una sección de una cadena con la de otra cadena utilizando el valor de CompareOptions especificado.

System_CAPS_pubmethodCompare(String, Int32, String, Int32)

Compara la sección final de una cadena con la de otra cadena.

System_CAPS_pubmethodCompare(String, Int32, String, Int32, CompareOptions)

Compara la sección final de una cadena con la de otra utilizando el valor de CompareOptions especificado.

System_CAPS_pubmethodCompare(String, String)

Compara dos cadenas.

System_CAPS_pubmethodCompare(String, String, CompareOptions)

Compara dos cadenas utilizando el valor de CompareOptions especificado.

System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto CompareInfo actual.(Invalida Object.Equals(Object)).

System_CAPS_protmethodFinalize()

Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por el recolector de basura. (Heredado de Object).

System_CAPS_pubmethodSystem_CAPS_staticGetCompareInfo(Int32)

Inicializa un nuevo objeto CompareInfo que está asociado a la referencia cultural con el identificador especificado.

System_CAPS_pubmethodSystem_CAPS_staticGetCompareInfo(Int32, Assembly)

Inicializa un nuevo objeto CompareInfo que está asociado a la referencia cultural especificada y que usa los métodos de comparación de cadenas del Assembly especificado.

System_CAPS_pubmethodSystem_CAPS_staticGetCompareInfo(String)

Inicializa un nuevo objeto CompareInfo que está asociado a la referencia cultural con el nombre especificado.

System_CAPS_pubmethodSystem_CAPS_staticGetCompareInfo(String, Assembly)

Inicializa un nuevo objeto CompareInfo que está asociado a la referencia cultural especificada y que usa los métodos de comparación de cadenas del Assembly especificado.

System_CAPS_pubmethodGetHashCode()

Sirve como función hash para el objeto CompareInfo actual, que se puede utilizar en algoritmos hash y estructuras de datos, como una tabla hash.(Invalida Object.GetHashCode()).

System_CAPS_pubmethodGetHashCode(String, CompareOptions)

Obtiene el código hash para una cadena basándose en las opciones de comparación especificadas.

System_CAPS_pubmethodGetSortKey(String)

Obtiene el criterio de ordenación para la cadena especificada.

System_CAPS_pubmethodGetSortKey(String, CompareOptions)

Obtiene un objeto SortKey para la cadena especificada utilizando el valor de CompareOptions especificado.

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_pubmethodIndexOf(String, Char)

Busca el carácter especificado y devuelve el índice de base cero de la primera aparición incluida en toda la cadena de origen.

System_CAPS_pubmethodIndexOf(String, Char, CompareOptions)

Busca el carácter especificado y devuelve el índice de base cero de la primera aparición incluida en toda la cadena de origen utilizando el valor de CompareOptions especificado.

System_CAPS_pubmethodIndexOf(String, Char, Int32)

Busca el carácter especificado y devuelve el índice de base cero de la primera aparición incluida en la sección de la cadena de origen que abarca desde el índice especificado hasta el final de la cadena.

System_CAPS_pubmethodIndexOf(String, Char, Int32, CompareOptions)

Busca el carácter especificado y devuelve el índice de base cero de la primera aparición incluida en la sección de la cadena de origen que abarca desde el índice especificado hasta el final de la cadena, utilizando el valor de CompareOptions especificado.

System_CAPS_pubmethodIndexOf(String, Char, Int32, Int32)

Busca el carácter especificado y devuelve el índice de base cero de la primera aparición incluida en la sección de la cadena de origen que comienza en el índice especificado y contiene el número de elementos especificado.

System_CAPS_pubmethodIndexOf(String, Char, Int32, Int32, CompareOptions)

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

System_CAPS_pubmethodIndexOf(String, String)

Busca la subcadena especificada y devuelve el índice de base cero de la primera aparición incluida en toda la cadena de origen.

System_CAPS_pubmethodIndexOf(String, String, CompareOptions)

Busca la subcadena especificada y devuelve el índice de base cero de la primera aparición incluida en toda la cadena de origen utilizando el valor de CompareOptions especificado.

System_CAPS_pubmethodIndexOf(String, String, Int32)

Busca la subcadena especificada y devuelve el índice de base cero de la primera aparición incluida en la sección de la cadena de origen que abarca desde el índice especificado hasta el final de la cadena.

System_CAPS_pubmethodIndexOf(String, String, Int32, CompareOptions)

Busca la subcadena especificada y devuelve el índice de base cero de la primera aparición incluida en la sección de la cadena de origen que abarca desde el índice especificado hasta el final de la cadena, utilizando el valor de CompareOptions especificado.

System_CAPS_pubmethodIndexOf(String, String, Int32, Int32)

Busca la subcadena especificada y devuelve el índice de base cero de la primera aparición incluida en la sección de la cadena de origen que comienza en el índice especificado y contiene el número de elementos especificado.

System_CAPS_pubmethodIndexOf(String, String, Int32, Int32, CompareOptions)

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

System_CAPS_pubmethodIsPrefix(String, String)

Determina si la cadena de origen especificada comienza con el prefijo especificado.

System_CAPS_pubmethodIsPrefix(String, String, CompareOptions)

Determina si la cadena de origen especificada comienza con el prefijo especificado utilizando el valor de CompareOptions especificado.

System_CAPS_pubmethodSystem_CAPS_staticIsSortable(Char)

Indica si se puede ordenar un carácter Unicode especificado.

System_CAPS_pubmethodSystem_CAPS_staticIsSortable(String)

Indica si se puede ordenar una cadena Unicode especificada.

System_CAPS_pubmethodIsSuffix(String, String)

Determina si la cadena de origen especificada termina con el sufijo especificado.

System_CAPS_pubmethodIsSuffix(String, String, CompareOptions)

Determina si la cadena de origen especificada termina con el sufijo especificado utilizando el valor de CompareOptions especificado.

System_CAPS_pubmethodLastIndexOf(String, Char)

Busca el carácter especificado y devuelve el índice de base cero de la última aparición incluida en toda la cadena de origen.

System_CAPS_pubmethodLastIndexOf(String, Char, CompareOptions)

Busca el carácter especificado y devuelve el índice de base cero de la última aparición incluida en toda la cadena de origen utilizando el valor de CompareOptions especificado.

System_CAPS_pubmethodLastIndexOf(String, Char, Int32)

Busca el carácter especificado y devuelve el índice de base cero de la última aparición incluida en la sección de la cadena de origen que abarca desde el comienzo de la cadena hasta el índice especificado.

System_CAPS_pubmethodLastIndexOf(String, Char, Int32, CompareOptions)

Busca el carácter especificado y devuelve el índice de base cero de la última aparición incluida en la sección de la cadena de origen que abarca desde el principio de la cadena hasta el índice especificado, utilizando el valor de CompareOptions especificado.

System_CAPS_pubmethodLastIndexOf(String, Char, Int32, Int32)

Busca el carácter especificado y devuelve el índice de base cero de la última aparición incluida en la sección de la cadena de origen que contiene el número de elementos especificado y termina en el índice especificado.

System_CAPS_pubmethodLastIndexOf(String, Char, Int32, Int32, CompareOptions)

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

System_CAPS_pubmethodLastIndexOf(String, String)

Busca la subcadena especificada y devuelve el índice de base cero de la última aparición incluida en toda la cadena de origen.

System_CAPS_pubmethodLastIndexOf(String, String, CompareOptions)

Busca la subcadena especificada y devuelve el índice de base cero de la última aparición incluida en toda la cadena de origen utilizando el valor de CompareOptions especificado.

System_CAPS_pubmethodLastIndexOf(String, String, Int32)

Busca la subcadena especificada y devuelve el índice de base cero de la última aparición incluida en la sección de la cadena de origen que abarca desde el comienzo de la cadena hasta el índice especificado.

System_CAPS_pubmethodLastIndexOf(String, String, Int32, CompareOptions)

Busca la subcadena especificada y devuelve el índice de base cero de la última aparición incluida en la sección de la cadena de origen que abarca desde el principio de la cadena hasta el índice especificado, utilizando el valor de CompareOptions especificado.

System_CAPS_pubmethodLastIndexOf(String, String, Int32, Int32)

Busca la subcadena especificada y devuelve el índice de base cero de la última aparición incluida en la sección de la cadena de origen que contiene el número de elementos especificado y termina en el índice especificado.

System_CAPS_pubmethodLastIndexOf(String, String, Int32, Int32, CompareOptions)

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

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficial del Object actual.(Heredado de Object).

System_CAPS_pubmethodToString()

Devuelve una cadena que representa el actual objeto CompareInfo.(Invalida Object.ToString()).

NombreDescripción
System_CAPS_pubinterfaceSystem_CAPS_privmethodIDeserializationCallback.OnDeserialization(Object)

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

Conventions for comparing and sorting data vary from culture to culture. For example, sort order may be based on phonetics or on the visual representation of characters. In East Asian languages, characters are sorted by the stroke and radical of ideographs. Sorting also depends on the order languages and cultures use for the alphabet. For example, the Danish language has an "Æ" character that it sorts after "Z" in the alphabet. In addition, comparisons may be case-sensitive or case-insensitive, and casing rules may also differ by culture. The T:System.Globalization.CompareInfo class is responsible for maintaining this culture-sensitive string comparison data and for performing culture-sensitive string operations.

Typically, you do not have to instantiate a T:System.Globalization.CompareInfo object directly, because one is used implicitly by all non-ordinal string comparison operations, including calls to the M:System.String.Compare(System.String,System.String) method. However, if you do want to retrieve a T:System.Globalization.CompareInfo object, you can do it in one of these ways:

  • By retrieving the value of the P:System.Globalization.CultureInfo.CompareInfo property for a particular culture.

  • By calling the static M:System.Globalization.CompareInfo.GetCompareInfo(System.String) method with a culture name. This allows for late-bound access to a T:System.Globalization.CompareInfo object.

Character sets include ignorable characters, which are characters that are not considered when performing a linguistic or culture-sensitive comparison. Comparison methods such as Overload:System.Globalization.CompareInfo.IndexOf and Overload:System.Globalization.CompareInfo.LastIndexOf do not consider such characters when they perform a culture-sensitive comparison. Ignorable characters include:

  • String.Empty. Culture-sensitive comparison methods will always find an empty string at the beginning (index zero) of the string being searched.

  • A character or string consisting of characters with code points that are not considered in the operation because of comparison options, In particular, the F:System.Globalization.CompareOptions.IgnoreNonSpace and F:System.Globalization.CompareOptions.IgnoreSymbols options produce searches in which symbols and nonspacing combining characters are ignored.

  • A string with code points that have no linguistic significance. For example, a soft hyphen (U+00AD) is always ignored in a culture-sensitive string comparison.

If a security decision depends on a string comparison or a case change, you should use the P:System.Globalization.CultureInfo.InvariantCulture property to ensure that the behavior is consistent, regardless of the culture settings of the operating system.

System_CAPS_noteNota

When possible, you should use string comparison methods that have a parameter of type T:System.Globalization.CompareOptions to specify the kind of comparison expected. As a general rule, use linguistic options (using the current culture) for comparing strings displayed in the user interface and specify F:System.Globalization.CompareOptions.Ordinal or F:System.Globalization.CompareOptions.OrdinalIgnoreCase for security comparisons.

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

using System;
using System.Text;
using System.Globalization;

public sealed class App
{
    static void Main(string[] args)
    {
        String[] sign = new String[] { "<", "=", ">" };

        // The code below demonstrates how strings compare 
        // differently for different cultures.
        String s1 = "Coté", s2 = "coté", s3 = "côte";

        // Set sort order of strings for French in France.
        CompareInfo ci = new CultureInfo("fr-FR").CompareInfo;
        Console.WriteLine("The LCID for {0} is {1}.", ci.Name, ci.LCID);

        // Display the result using fr-FR Compare of Coté = coté.  	
        Console.WriteLine("fr-FR Compare: {0} {2} {1}",
            s1, s2, sign[ci.Compare(s1, s2, CompareOptions.IgnoreCase) + 1]);

        // Display the result using fr-FR Compare of coté > côte.
        Console.WriteLine("fr-FR Compare: {0} {2} {1}",
            s2, s3, sign[ci.Compare(s2, s3, CompareOptions.None) + 1]);

        // Set sort order of strings for Japanese as spoken in Japan.
        ci = new CultureInfo("ja-JP").CompareInfo;
        Console.WriteLine("The LCID for {0} is {1}.", ci.Name, ci.LCID);

        // Display the result using ja-JP Compare of coté < côte. 
        Console.WriteLine("ja-JP Compare: {0} {2} {1}",
            s2, s3, sign[ci.Compare(s2, s3) + 1]);
    }
}

// This code produces the following output.
// 
// The LCID for fr-FR is 1036.
// fr-FR Compare: Coté = coté
// fr-FR Compare: coté > côte
// The LCID for ja-JP is 1041.
// ja-JP Compare: coté < côte

Plataforma universal de Windows
Disponible desde 8
.NET Framework
Disponible desde 1.1
Biblioteca de clases portable
Se admite en: plataformas portátiles de .NET
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Windows Phone
Disponible desde 8.1

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: