Option Compare, instruction

Mise à jour : novembre 2007

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

Option Compare { Binary | Text }

Éléments

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

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

Notes

Si elle est utilisée, l'instruction Option Compare doit apparaître dans un fichier avant les autres instructions du code source.

L'instruction Option Compare spécifie la méthode de comparaison de chaînes (Binary ou Text) pour une classe, un module ou une structure. Si le module ne contient pas d'instruction Option Compare, la méthode de comparaison de texte par défaut est de type Binary.

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

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) < (Ø = ø)

Vous pouvez également définir Option Compare dans l'environnement de développement intégré (IDE) de Visual Studio ou sur une ligne de commande.

Remarque :

Selon vos paramètres actifs ou votre édition, les boîtes de dialogue et les commandes de menu que vous voyez peuvent différer de celles qui sont décrites dans l'aide. Pour modifier vos paramètres, cliquez sur Importation et exportation de paramètres dans le menu Outils. Pour plus d'informations, consultez Paramètres Visual Studio.

Pour définir Option Compare dans l'IDE

  1. Dans le menu Outils, cliquez sur Options.

  2. Ouvrez le nœud Projets et solutions.

  3. Choisissez Valeurs par défaut VB.

  4. Modifiez le paramètre Option Compare.

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.

' Set the string comparison method to Binary ("AAA" < "aaa").
Option Compare Binary

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.

' Set the string comparison method to Text ("AAA" = "aaa").
Option Compare Text

Voir aussi

Référence

Opérateurs de comparaison (Visual Basic)

InStr, fonction (Visual Basic)

InStrRev, fonction (Visual Basic)

Replace, fonction (Visual Basic)

Split, fonction (Visual Basic)

StrComp, fonction (Visual Basic)

/optioncompare

Option Explicit, instruction (Visual Basic)

Option Strict, instruction

/optionexplicit

/optionstrict

Valeurs par défaut VB, Projets, boîte de dialogue Options