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. Se traduit par des comparaisons de chaînes basées sur un ordre de tri dérivé des représentations binaires internes des caractères.

Ce type de comparaison est utile surtout si les chaînes peuvent contenir des caractères qui ne doivent ne pas être interprétées comme du texte. Dans ce cas, il convient de ne pas fausser les comparaisons avec des équivalences alphabétiques comme, par exemple, quand la casse n'est pas respectée.

Text

Facultatif. Se traduit par des comparaisons de chaînes basées sur un ordre de tri de texte sans respect de la casse déterminé par les paramètres régionaux de votre système.

Ce type de comparaison est utile si vos chaînes contiennent toutes des caractères de texte et si vous voulez les comparer en prenant en compte les équivalences alphabétiques, c'est-à-dire des lettres très proches ou de casse différente. Par exemple, vous pouvez faire en sorte que les caractères A et a soient considérés comme identiques et que les caractères Ä et ä précèdent 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 permet de spécifier 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 de type Binary permet de comparer la valeur Unicode numérique de chaque caractère dans chaque chaîne. Une comparaison de type Text permet de comparer 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 code. 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 < À < Ê < Ø < à < ê < ø

Quand les mêmes caractères d'une même page de codes sont triés à l'aide de Option Compare Text, l'ordre de tri de texte suivant est généré.

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

En l'absence d'instruction Option Compare

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

Notes

Il est possible que pour certains des éléments de l'interface utilisateur de Visual Studio, votre ordinateur affiche des noms ou des emplacements différents de ceux indiqués 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, voir 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 to the Project Designer.

  2. Cliquez sur l'onglet Compiler.

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

Quand vous créez un projet, le paramètre Option Compare de l'onglet Compiler reprend la définition de Option Compare dans 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 de 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, supprimez les commentaires 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, supprimez les commentaires 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