Partage 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.

Syntaxe

Option Compare { Binary | Text }  

Éléments

Terme Définition
Binary Optionnel. 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 Optionnel. 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, le paramètre Option Compare sur la page de compilation, le Concepteur de projets (Visual Basic) est utilisé. Si vous utilisez le compilateur de ligne de commande, vous pouvez utiliser l’option du compilateur -optionstrict.

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, consultez Personnalisation de l’IDE.

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.

  2. Cliquez sur l’onglet Compiler.

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

Lorsque vous créez un projet, le paramètre Option Comparer sous l’onglet Compiler est défini sur le paramètre Option Comparer 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 vb Defaults est binaire.

Pour définir Option Compare sur la ligne de commande

  • Incluez l’option du compilateur-optioncompare dans la commande vbc.

Exemple 1

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

Exemple 2

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