Partager via


Option Compare, instruction

Déclare la méthode de comparaison par défaut à utiliser lors de la comparaison de données de type chaîne.

Option Compare { Binary | Text }

Composants

Terme

Définition

Binary

Facultatif.Donne lieu à des comparaisons de chaînes basées sur un ordre de tri dérivé de la représentation binaire interne des caractères.

Ce type de comparaison est utile surtout si les chaînes peuvent contenir des caractères qui ne seront pas interprétés en tant que texte.Dans ce cas, vous ne souhaitez pas influencer des comparaisons avec les équivalences alphabétiques, telles que le non-respect de la casse.

Text

Facultatif.Fournit des comparaisons de chaînes basées sur un ordre de tri ne respectant pas la casse et qui est déterminé par les paramètres régionaux de votre système.

Ce type de comparaison est également utile si vos chaînes contiennent tous les caractères de texte, et que vous voulez les comparer en prenant en considération les équivalences alphabétiques telles que le non-respect de la casse et les caractères collés.Par exemple, il se peut que vous souhaitiez considérer A et a comme deux caractères équivalents et Ä et ä comme deux caractères précédant B et b.

Notes

Si elle est utilisée, l'instruction Option Compare doit apparaître dans un fichier avant toute autre instruction de code source.

L'instruction Option Compare spécifie la méthode de comparaison de chaînes (Binary ou Text).La méthode de comparaison de texte par défaut est Binary.

Une comparaison Binary compare la valeur Unicode numérique de chaque caractère dans chaque chaîne.Une comparaison Text compare chaque caractère Unicode selon sa signification lexicale dans la culture actuelle.

Dans Microsoft Windows, l'ordre de tri est déterminé par la page de codes.Pour plus d'informations, consultez Pages de codes.

Dans l'exemple suivant, les caractères de la page de codes Anglais/Européen (ANSI 1252) sont triés à l'aide de Option Compare Binary, qui génère un ordre de tri binaire standard.

A < B < E < Z < a < b < e < z < À < Ê < Ø < à < ê < ø

Lorsque les mêmes caractères de la même page de codes sont triés à l'aide de Option Compare Text, on obtient l'ordre de tri de texte ci-dessous.

(A=a) < (À = à) < (B=b) < (E=e) < (Ê = ê) < (Z=z) < (Ø = ø)

Lorsqu'aucune instruction Option Compare n'est présente

Si le code source ne contient pas d'instruction Option Compare, le paramètre Option Compare sur Page Compiler, Concepteur de projets (Visual Basic) est utilisé.Si vous utilisez le compilateur de ligne de commande, le paramètre spécifié par l'option du compilateur /optioncompare est utilisé.

[!REMARQUE]

Il est possible que votre ordinateur affiche des noms ou des emplacements différents pour certains des éléments d'interface utilisateur de Visual Studio dans les instructions suivantes. L'édition de Visual Studio dont vous disposez et les paramètres que vous utilisez déterminent ces éléments. Pour plus d'informations, consultez Paramètres Visual Studio.

Pour définir Option Compare dans l'IDE

  1. Dans l'Explorateur de solutions, sélectionnez un projet.Dans le menu Projet, cliquez sur Propriétés.Pour plus d'informations, consultez Introduction au Concepteur de projets.

  2. Cliquez sur l'onglet Compiler.

  3. Définissez la valeur dans la zone Option Compare.

Lorsque vous créez un projet, le paramètre Option Compare de l'onglet Compiler a la valeur du paramètre Option Compare de la boîte de dialogue Options.Pour modifier ce paramètre, dans le menu Outils, cliquez sur Options.Dans la boîte de dialogue Options, développez Projets et solutions, puis cliquez sur Valeurs par défaut VB.Le paramètre par défaut initial dans Valeurs par défaut VB est Binaire.

Pour définir Option Compare sur la ligne de commande

  • Incluez l'option du compilateur /optioncompare dans la commande vbc.

Exemple

L'exemple suivant utilise l'instruction Option Compare pour définir la comparaison binaire comme méthode de comparaison de chaînes par défaut.Pour utiliser ce code, annulez les marques de commentaire de l'instruction Option Compare Binary, et placez-la en haut du fichier source.

' Option Compare Binary

Console.WriteLine("A" < "a")
' Output: True

L'exemple suivant utilise l'instruction Option Compare pour définir l'ordre de tri de texte sans respect de la casse comme méthode de comparaison de chaînes par défaut.Pour utiliser ce code, annulez les marques de commentaire de l'instruction Option Compare Text, et placez-la en haut du fichier source.

' Option Compare Text

Console.WriteLine("A" = "a")
' Output: True

Voir aussi

Référence

/optioncompare

Opérateurs de comparaison (Visual Basic)

Like (opérateur Visual Basic)

Fonctions de chaîne (Visual Basic)

Option Explicit, instruction (Visual Basic)

Option Strict, instruction

InStr

InStrRev

Replace

Split

StrComp

Concepts

Opérateurs de comparaison en Visual Basic