Option Strict, instruction

Limite les conversions de types de données implicites uniquement aux conversions étendues, rejette la liaison tardive et rejette la saisie implicite qui résulte en un type Object.

Option Strict { On | Off }

Éléments

Terme	Définition
On	Facultatif. Active la vérification Option Strict.
Off	Facultatif. Désactive la vérification Option Strict. Si On ou Off n'est pas spécifié, la valeur par défaut est Off.

Notes

Lorsque Option Strict On ou Option Strict apparaît dans un fichier, les conditions suivantes provoquent une erreur de compilation :

• Conversions restrictives implicites

• Liaison tardive

• Type implicite qui génère un type Object

Notes

Dans les configurations d'avertissement que vous pouvez définir sur Page Compiler, Concepteur de projets (Visual Basic), il existe trois paramètres qui correspondent aux trois conditions qui provoquent une erreur de compilation. Pour plus d'informations sur l'utilisation de ces paramètres, consultez Pour définir les configurations des avertissements dans l'IDE plus loin dans cette rubrique.

L'instruction Option Strict Off désactive l'erreur et l'avertissement examinant pour chacune des trois conditions, même si les paramètres IDE associés spécifient d'activer ces erreurs ou avertissements.

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

Lorsque vous affectez la valeur On à Option Strict, Visual Basic fournit la vérification de compilation qui apporte l'assistance suivante :

• Cela permet la prise en charge de IntelliSens pour vos variables et vos paramètres. Il vous permet de voir leurs propriétés et leurs autres membres à mesure que vous tapez le code.

• Il permet au compilateur d'effectuer la vérification des types. La vérification de type vous aide à rechercher les instructions susceptibles d'échouer au moment de l'exécution en raison d'erreurs de conversion de type. Il identifie également les appels de méthodes sur les objets qui ne prennent pas en charge ces méthodes.

Erreurs de conversion restrictive implicite

Les erreurs de conversion restrictive implicite se produisent lorsqu'il y a une conversion de types de données implicite qui est une conversion restrictive.

Visual Basic peut convertir de nombreux types de données en d'autres types de données. Une perte de données peut se produire si la valeur de l'un des types de données est convertie en un type de données dont la précision ou la capacité est moindre. Une erreur d'exécution se produit si une telle conversion restrictive échoue. Option Strict garantit la notification de compilation de ces conversions restrictives afin qu'ils puissent être évités. Pour plus d'informations, consultez Conversions implicites et explicites (Visual Basic) et Conversions étendues et restrictives (Visual Basic).

Les conversions qui peuvent provoquer des erreurs se composent des conversions implicites qui se produisent dans les expressions. Pour plus d'informations, consultez les rubriques suivantes :

• +, opérateur (Visual Basic)

• += (opérateur Visual Basic)

• \, opérateur (Visual Basic)

• /=, opérateur (Visual Basic)

• Char, type de données (Visual Basic)

Lorsque vous concaténez des chaînes à l'aide de &, opérateur (Visual Basic), toutes les conversions en chaînes sont considérées élargir. Pour que ces conversions ne génèrent pas d'erreur de conversion restrictive implicite, même si Option Strict est activée.

Lorsque vous appelez une méthode qui possède un argument qui contient un type de données différent du paramètre correspondant, une conversion restrictive provoque une erreur de compilation si Option Strict est activé. Vous pouvez éviter cette erreur de compilation en utilisant une conversion étendue ou une conversion explicite.

Les erreurs de conversion restrictive implicite sont supprimées lors de la compilation pour les conversions à partir des éléments d'une collection For Each…Next vers la variable de contrôle de boucle. Cela se produit même si Option Strict est activé. Pour plus d'informations, consultez la section « Conversions restrictives » dans For Each...Next, instruction (Visual Basic).

Erreurs de liaison tardive

Un objet a une liaison tardive lorsqu'il est assigné à une propriété ou à une méthode d'une variable déclarée comme étant de type Object. Pour plus d'informations, consultez Liaison anticipée et liaison tardive (Visual Basic).

Erreurs de type d'objet implicite

Les erreurs de type d'objet implicite se produisent lorsqu'un type approprié ne peut pas être déduit pour une variable déclarée, de sorte qu'un type Object est déduit. Cela se produit essentiellement lorsque vous utilisez une instruction Dim pour déclarer une variable sans utiliser une clause As et que Option Infer est désactivé. Pour plus d'informations, consultez Instruction Option Infer et Spécification du langage Visual Basic.

Pour les paramètres de méthode, la clause As est facultative si Option Strict est désactivé. Toutefois, si un paramètre utilise une clause As, ils doivent tous l'utiliser. Si Option Strict est activé, la clause As est nécessaire pour chaque définition de paramètre.

Si vous déclarez une variable sans utiliser de clause As et que vous la définissez sur Nothing, la variable a un type Object. Aucune erreur de compilation ne se produit dans ce cas lorsque Option Strict est activé et Option Infer est activé. Un exemple est Dim something = Nothing.

Valeurs et types de données par défaut

Le tableau suivant décrit les résultats des diverses combinaisons de spécification du type de données et de l'initialiseur dans une Dim, instruction (Visual Basic).

Type de données spécifié ?	Initialiseur spécifié ?	Exemple	Résultat
Non	Non	Dim qty	Si Option Strict est désactivé (valeur par défaut), la variable a la valeur Nothing. Si Option Strict est activée, une erreur de compilation se produit.
Non	Oui	Dim qty = 5	Si Option Infer est activé (valeur par défaut), la variable prend le type de données de l'initialiseur. Consultez Inférence de type local (Visual Basic). Si Option Infer et Option Strict sont désactivés, la variable prend le type de données de Object. Si Option Infer est désactivé et Option Strict est activé, une erreur de compilation se produit.
Oui	Non	Dim qty As Integer	La variable est initialisée avec la valeur par défaut du type de données. Pour plus d'informations, consultez Dim, instruction (Visual Basic).
Oui	Oui	Dim qty As Integer = 5	Si le type de données de l'initialiseur n'est pas convertible en type de données spécifié, une erreur de compilation se produit.

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

Si le code source ne contient pas d'instruction Option Strict, le paramètre Option strict sur Page Compiler, Concepteur de projets (Visual Basic) est utilisé. La Page Compiler dispose des paramètres qui fournissent un contrôle supplémentaire sur les conditions qui génèrent une erreur.

Si vous utilisez le compilateur de ligne de commande, vous pouvez utiliser l'option du compilateur /optionstrict pour spécifier un paramètre pour Option Strict.

Pour définir Option Strict dans l'IDE

Notes

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.

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 Compilation et définissez la valeur figurant dans la zone Option Strict.

Pour définir les configurations des avertissements dans l'IDE

Lorsque vous utilisez Page Compiler, Concepteur de projets (Visual Basic) au lieu d'une instruction Option Strict, vous avez le contrôle supplémentaire des conditions qui génèrent des erreurs. La section Configurations des avertissements de Compiler la page contient des paramètres qui correspondent aux trois conditions qui provoquent une erreur de compilation lorsque Option Strict est activé. Vous trouverez ci-dessous ces paramètres :

• Conversion implicite

• Liaison tardive ; l'appel pourrait échouer lors de l'exécution

• Type implicite ; objet supposé

Lorsque vous affectez la valeur On à Option Strict, chacun de ces trois paramètres de configuration d'avertissement prend la valeur Erreur. Lorsque vous affectez la valeur Off à Option Strict, chacun des trois paramètres prend la valeur Aucun.

Vous pouvez remplacer individuellement chaque paramètre de configuration d'avertissement par Aucun, Avertissement ou Erreur. Si les trois paramètres de configuration de l'avertissement sont définis sur Erreur, On apparaît dans la zone Option strict. Si les trois sont définis sur None, Off apparaît dans cette zone. Pour toute autre combinaison de ces paramètres, (personnalisé) apparaît.

Pour définir la valeur par défaut d'Option Strict pour les nouveaux projets

Lorsque vous créez un projet, le paramètre Option Strict de l'onglet Compiler a la valeur du paramètre Option Strict de la boîte de dialogue Options.

Pour définir la boîte de dialogue Option Strict, 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 Off.

Pour définir Option Strict sur la ligne de commande

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

Exemple

Les exemples suivants illustrent des erreurs de compilation provoquées par les conversions de types implicites qui sont des conversions restrictives. Cette catégorie d'erreurs correspond à la condition Conversion implicite sur la Page Compiler.

L'exemple suivant illustre une erreur de compilation provoquée par la liaison tardive. Cette catégorie d'erreurs correspond à la condition Liaison tardive ; l'appel peut échouer au moment de l'exécution sur la Page Compiler.

Les exemples suivants illustrent des erreurs provoquées par des variables qui sont déclarées avec un type implicite d'Object. Cette catégorie d'erreurs correspond à la condition Type implicite ; objet pris par défaut sur la Page Compiler.

Voir aussi

Tâches

Comment : accéder aux membres d'un objet (Visual Basic)

Liaison tardive dans les solutions Office

Référence

Page Compiler, Concepteur de projets (Visual Basic)

Option Explicit, instruction (Visual Basic)

Fonctions de conversion de types de données (Visual Basic)

/optionstrict

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

Concepts

Conversions étendues et restrictives (Visual Basic)

Conversions implicites et explicites (Visual Basic)

Expressions incorporées en XML (Visual Basic)

Conversion simplifiée des délégués (Visual Basic)

Historique des modifications

Date	Historique	Motif
Avril 2011	A ajouté des informations sur les trois types d'erreurs Option Strict et a ajouté des exemples.	Améliorations apportées aux informations.