CompareInfo Classe

Définition

Espace de noms:: System.Globalization

Assemblys:: mscorlib.dll, System.Globalization.dll

Assemblys:: netstandard.dll, System.Runtime.dll

Assembly:: System.Globalization.dll

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Source:: CompareInfo.cs

Source:: CompareInfo.cs

Source:: CompareInfo.cs

Source:: CompareInfo.cs

Source:: CompareInfo.cs

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Implémente un ensemble de méthodes pour les comparaisons de chaînes sensibles à la culture.

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

Héritage: Object
CompareInfo

Attributs: SerializableAttribute ComVisibleAttribute

Implémente: IDeserializationCallback

Remarques

Les conventions de comparaison et de tri des données varient de la culture à la culture. Par exemple, l’ordre de tri peut être basé sur des phonétiques ou sur la représentation visuelle des caractères. Dans les langues d'Asie orientale, les caractères sont classés en fonction du trait et de la clé des idéogrammes. Le tri dépend également de l’ordre des langues et cultures utilisées pour l’alphabet. Par exemple, la langue danoise emploie un caractère "Æ" qu'elle place après "Z" dans l'alphabet. En outre, les comparaisons peuvent être sensibles ou insensibles à la casse, et les règles de casse peuvent également différer selon les cultures. La CompareInfo classe est responsable de la maintenance de ces données de comparaison de chaînes sensibles à la culture et de l’exécution d’opérations de chaîne sensibles à la culture.

En règle générale, vous n’avez pas besoin d’instancier un CompareInfo objet directement, car il est utilisé implicitement par toutes les opérations de comparaison de chaînes non ordinales, y compris les appels à la String.Compare méthode. Toutefois, si vous souhaitez récupérer un CompareInfo objet, vous pouvez le faire de l’une des manières suivantes :

En récupérant la valeur de la propriété CultureInfo.CompareInfo pour une culture particulière.
En appelant la méthode statique GetCompareInfo en utilisant un nom de culture. Cela permet d’accéder tardivement à un CompareInfo objet.

Valeurs de recherche ignorées

Les jeux de caractères incluent des caractères ignorés, qui sont des caractères qui ne sont pas pris en compte lors de l’exécution d’une comparaison linguistique ou culturelle. Les méthodes de comparaison telles que IndexOf et LastIndexOf ne tiennent pas compte de ces caractères lors d'une comparaison sensible à la culture. Les caractères que l’on peut ignorer sont les suivants :

String.Empty. Les méthodes de comparaison sensibles à la culture trouvent toujours une chaîne vide au début (index zéro) de la chaîne recherchée.
Caractère ou chaîne de caractères composé de caractères avec des points de code qui ne sont pas pris en compte dans l’opération en raison des options de comparaison. En particulier, les options CompareOptions.IgnoreNonSpace et CompareOptions.IgnoreSymbols produisent des recherches dans lesquelles les symboles et les caractères de combinaison non espacés sont ignorés.
Chaîne avec des points de code qui n’ont aucune signification linguistique. Par exemple, un trait d’union conditionnel (U+00AD) est toujours ignoré dans une comparaison de chaînes sensibles à la culture.

Considérations relatives à la sécurité

Si une décision de sécurité dépend d’une comparaison de chaînes ou d’une modification de cas, vous devez utiliser la InvariantCulture propriété pour vous assurer que le comportement est cohérent, quels que soient les paramètres de culture du système d’exploitation.

Note

Si possible, vous devez utiliser des méthodes de comparaison de chaînes qui ont un paramètre de type CompareOptions pour spécifier le type de comparaison attendu. En règle générale, utilisez des options linguistiques (à l’aide de la culture actuelle) pour comparer les chaînes affichées dans l’interface utilisateur et spécifier Ordinal ou OrdinalIgnoreCase pour les comparaisons de sécurité.

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

Propriétés

Nom	Description
LCID	Obtient l’identificateur de culture correctement formé pour le fichier actif CompareInfo.
Name	Obtient le nom de la culture utilisée pour trier les opérations par cet CompareInfo objet.
Version	Obtient des informations sur la version d’Unicode utilisée pour comparer et trier des chaînes.

Méthodes

Nom	Description
Compare(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions)	Compare deux étendues en lecture seule de caractères.
Compare(String, Int32, Int32, String, Int32, Int32, CompareOptions)	Compare une section d’une chaîne à une section d’une autre chaîne à l’aide de la valeur spécifiée CompareOptions .
Compare(String, Int32, Int32, String, Int32, Int32)	Compare une section d’une chaîne à une section d’une autre chaîne.
Compare(String, Int32, String, Int32, CompareOptions)	Compare la section de fin d’une chaîne à la section de fin d’une autre chaîne à l’aide de la valeur spécifiée CompareOptions .
Compare(String, Int32, String, Int32)	Compare la section de fin d’une chaîne à la section de fin d’une autre chaîne.
Compare(String, String, CompareOptions)	Compare deux chaînes à l’aide de la valeur spécifiée CompareOptions .
Compare(String, String)	Compare deux chaînes.
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel CompareInfo .
GetCompareInfo(Int32, Assembly)	Initialise un nouvel CompareInfo objet associé à la culture spécifiée et qui utilise des méthodes de comparaison de chaînes dans le fichier spécifié Assembly.
GetCompareInfo(Int32)	Initialise un nouvel CompareInfo objet associé à la culture avec l’identificateur spécifié.
GetCompareInfo(String, Assembly)	Initialise un nouvel CompareInfo objet associé à la culture spécifiée et qui utilise des méthodes de comparaison de chaînes dans le fichier spécifié Assembly.
GetCompareInfo(String)	Initialise un nouvel CompareInfo objet associé à la culture avec le nom spécifié.
GetHashCode()	Sert de fonction de hachage pour le courant CompareInfo pour les algorithmes de hachage et les structures de données, comme une table de hachage.
GetHashCode(ReadOnlySpan<Char>, CompareOptions)	Obtient le code de hachage d’une étendue de caractères en fonction des options de comparaison spécifiées.
GetHashCode(String, CompareOptions)	Obtient le code de hachage d’une chaîne en fonction des options de comparaison spécifiées.
GetSortKey(ReadOnlySpan<Char>, Span<Byte>, CompareOptions)	Calcule une clé de tri pour l’entrée spécifiée.
GetSortKey(String, CompareOptions)	Obtient un SortKey objet pour la chaîne spécifiée à l’aide de la valeur spécifiée CompareOptions .
GetSortKey(String)	Obtient la clé de tri pour la chaîne spécifiée.
GetSortKeyLength(ReadOnlySpan<Char>, CompareOptions)	Obtient le nombre total d’octets de clé de tri qui seraient générés à partir de l’entrée spécifiée.
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
IndexOf(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions, Int32)	Recherche la première occurrence d’une sous-chaîne dans une chaîne source.
IndexOf(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions)	Recherche la première occurrence d’une sous-chaîne dans l’étendue de caractères en lecture seule spécifiée.
IndexOf(ReadOnlySpan<Char>, Rune, CompareOptions)	Recherche la première occurrence d’une Rune étendue de caractères en lecture seule spécifiée.
IndexOf(String, Char, CompareOptions)	Recherche le caractère spécifié et retourne l’index de base zéro de la première occurrence dans la chaîne source entière à l’aide de la valeur spécifiée CompareOptions .
IndexOf(String, Char, Int32, CompareOptions)	Recherche le caractère spécifié et retourne l’index de base zéro de la première occurrence dans la section de la chaîne source qui s’étend de l’index spécifié à la fin de la chaîne à l’aide de la valeur spécifiée CompareOptions .
IndexOf(String, Char, Int32, Int32, CompareOptions)	Recherche le caractère spécifié et retourne l’index de base zéro de la première occurrence dans la section de la chaîne source qui commence à l’index spécifié et contient le nombre d’éléments spécifié à l’aide de la valeur spécifiée CompareOptions .
IndexOf(String, Char, Int32, Int32)	Recherche le caractère spécifié et retourne l’index de base zéro de la première occurrence dans la section de la chaîne source qui commence à l’index spécifié et contient le nombre spécifié d’éléments.
IndexOf(String, Char, Int32)	Recherche le caractère spécifié et retourne l’index de base zéro de la première occurrence dans la section de la chaîne source qui s’étend de l’index spécifié à la fin de la chaîne.
IndexOf(String, Char)	Recherche le caractère spécifié et retourne l’index de base zéro de la première occurrence dans la chaîne source entière.
IndexOf(String, String, CompareOptions)	Recherche la sous-chaîne spécifiée et retourne l’index de base zéro de la première occurrence dans la chaîne source entière à l’aide de la valeur spécifiée CompareOptions .
IndexOf(String, String, Int32, CompareOptions)	Recherche la sous-chaîne spécifiée et retourne l’index de base zéro de la première occurrence dans la section de la chaîne source qui s’étend de l’index spécifié à la fin de la chaîne à l’aide de la valeur spécifiée CompareOptions .
IndexOf(String, String, Int32, Int32, CompareOptions)	Recherche la sous-chaîne spécifiée et retourne l’index de base zéro de la première occurrence dans la section de la chaîne source qui commence à l’index spécifié et contient le nombre spécifié d’éléments à l’aide de la valeur spécifiée CompareOptions .
IndexOf(String, String, Int32, Int32)	Recherche la sous-chaîne spécifiée et retourne l’index de base zéro de la première occurrence dans la section de la chaîne source qui commence à l’index spécifié et contient le nombre spécifié d’éléments.
IndexOf(String, String, Int32)	Recherche la sous-chaîne spécifiée et retourne l’index de base zéro de la première occurrence dans la section de la chaîne source qui s’étend de l’index spécifié à la fin de la chaîne.
IndexOf(String, String)	Recherche la sous-chaîne spécifiée et retourne l’index de base zéro de la première occurrence dans la chaîne source entière.
IsPrefix(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions, Int32)	Détermine si une chaîne commence par un préfixe spécifique.
IsPrefix(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions)	Détermine si une étendue de caractères en lecture seule commence par un préfixe spécifique.
IsPrefix(String, String, CompareOptions)	Détermine si la chaîne source spécifiée commence par le préfixe spécifié à l’aide de la valeur spécifiée CompareOptions .
IsPrefix(String, String)	Détermine si la chaîne source spécifiée commence par le préfixe spécifié.
IsSortable(Char)	Indique si un caractère Unicode spécifié est triable.
IsSortable(ReadOnlySpan<Char>)	Indique si une étendue de caractères En lecture seule Unicode spécifiée est triable.
IsSortable(Rune)	Indique si un élément spécifié Rune est triable.
IsSortable(String)	Indique si une chaîne Unicode spécifiée est triable.
IsSuffix(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions, Int32)	Détermine si une chaîne se termine par un suffixe spécifique.
IsSuffix(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions)	Détermine si une étendue de caractères en lecture seule se termine par un suffixe spécifique.
IsSuffix(String, String, CompareOptions)	Détermine si la chaîne source spécifiée se termine par le suffixe spécifié à l’aide de la valeur spécifiée CompareOptions .
IsSuffix(String, String)	Détermine si la chaîne source spécifiée se termine par le suffixe spécifié.
LastIndexOf(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions, Int32)	Recherche la dernière occurrence d’une sous-chaîne dans une chaîne source.
LastIndexOf(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions)	Recherche la dernière occurrence d’une sous-chaîne dans l’étendue de caractères en lecture seule spécifiée.
LastIndexOf(ReadOnlySpan<Char>, Rune, CompareOptions)	Recherche la dernière occurrence d’une Rune étendue de caractères en lecture seule spécifiée.
LastIndexOf(String, Char, CompareOptions)	Recherche le caractère spécifié et retourne l’index de base zéro de la dernière occurrence dans la chaîne source entière à l’aide de la valeur spécifiée CompareOptions .
LastIndexOf(String, Char, Int32, CompareOptions)	Recherche le caractère spécifié et retourne l’index de base zéro de la dernière occurrence dans la section de la chaîne source qui s’étend du début de la chaîne à l’index spécifié à l’aide de la valeur spécifiée CompareOptions .
LastIndexOf(String, Char, Int32, Int32, CompareOptions)	Recherche le caractère spécifié et retourne l’index de base zéro de la dernière occurrence dans la section de la chaîne source qui contient le nombre spécifié d’éléments et se termine à l’index spécifié à l’aide de la valeur spécifiée CompareOptions .
LastIndexOf(String, Char, Int32, Int32)	Recherche le caractère spécifié et retourne l’index de base zéro de la dernière occurrence dans la section de la chaîne source qui contient le nombre spécifié d’éléments et se termine à l’index spécifié.
LastIndexOf(String, Char, Int32)	Recherche le caractère spécifié et retourne l’index de base zéro de la dernière occurrence dans la section de la chaîne source qui s’étend du début de la chaîne à l’index spécifié.
LastIndexOf(String, Char)	Recherche le caractère spécifié et retourne l’index de base zéro de la dernière occurrence dans la chaîne source entière.
LastIndexOf(String, String, CompareOptions)	Recherche la sous-chaîne spécifiée et retourne l’index de base zéro de la dernière occurrence dans la chaîne source entière à l’aide de la valeur spécifiée CompareOptions .
LastIndexOf(String, String, Int32, CompareOptions)	Recherche la sous-chaîne spécifiée et retourne l’index de base zéro de la dernière occurrence dans la section de la chaîne source qui s’étend du début de la chaîne à l’index spécifié à l’aide de la valeur spécifiée CompareOptions .
LastIndexOf(String, String, Int32, Int32, CompareOptions)	Recherche la sous-chaîne spécifiée et retourne l’index de base zéro de la dernière occurrence dans la section de la chaîne source qui contient le nombre spécifié d’éléments et se termine à l’index spécifié à l’aide de la valeur spécifiée CompareOptions .
LastIndexOf(String, String, Int32, Int32)	Recherche la sous-chaîne spécifiée et retourne l’index de base zéro de la dernière occurrence dans la section de la chaîne source qui contient le nombre spécifié d’éléments et se termine à l’index spécifié.
LastIndexOf(String, String, Int32)	Recherche la sous-chaîne spécifiée et retourne l’index de base zéro de la dernière occurrence dans la section de la chaîne source qui s’étend du début de la chaîne à l’index spécifié.
LastIndexOf(String, String)	Recherche la sous-chaîne spécifiée et retourne l’index de base zéro de la dernière occurrence dans la chaîne source entière.
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l’objet actuel CompareInfo .

Implémentations d’interfaces explicites

Nom	Description
IDeserializationCallback.OnDeserialization(Object)	S’exécute lorsque l’ensemble du graphique d’objet a été désérialisé.

Méthodes d’extension

Nom	Description
GetStringComparer(CompareInfo, CompareOptions)	Retourne un StringComparer objet basé sur les règles de comparaison de chaînes sensibles à la culture d’un objet spécifié CompareInfo .

S’applique à

Voir aussi

Commentaires

Cette page a-t-elle été utile ?