Option Strict ステートメント

[アーティクル]
08/09/2011

暗黙的なデータ型変換を拡大変換だけに制限し、遅延バインディングを禁止し、Object 型になる暗黙の型指定を禁止します。

Option Strict { On | Off }

指定項目

語句	定義
On	省略可能です。 Option Strict チェックを有効にします。
Off	省略可能です。 Option Strict チェックを無効にします。 On または Off を指定しない場合は、既定で Off になります。

解説

Option Strict On または Option Strict がファイル内にあるとき、次の条件によってコンパイル時のエラーが発生します。

暗黙の縮小変換
遅延バインディング
Object 型になる暗黙的な型指定

注意

[コンパイル] ページ (プロジェクトデザイナー) (Visual Basic) で設定できる警告の構成には、コンパイル時のエラーの原因となる 3 つの条件に対応する設定があります。これらの設定の使用方法については、このトピックの後半の「IDE で警告の構成を設定するには」を参照してください。

Option Strict Off ステートメントは、3 つの条件すべてで (関連する IDE 設定でエラーまたは警告がオンになっている場合でも) エラーと警告のチェックをオフにします。

Option Strict ステートメントを使用する場合は、ファイル内の他のどのコードステートメントよりも前に記述する必要があります。

Option Strict が Onに設定されていると、Visual Basic はコンパイル時のチェックによって、次の情報を提供します。

変数に対する IntelliSense サポートが有効になります。これにより、コードの入力時に、プロパティや他のメンバーを表示できます。
コンパイラで型チェックを実行できます。型チェックによって、型変換のエラーによって実行時にエラーになるステートメントを見つけることができます。また、それらのメソッドをサポートしていないオブジェクトでのメソッドの呼び出しも識別します。

暗黙の縮小変換エラー

暗黙的なデータ型変換が縮小変換である場合、暗黙の縮小変換エラーが発生します。

Visual Basic は、多くのデータ型と他のデータ型との間の変換を行います。変換元のデータ型より変換先のデータ型の方が精度が低い場合、または容量が小さい場合は、データが失われる可能性があります。このような縮小変換が失敗した場合は、実行時エラーが発生します。 Option Strict を使用すると、実行時エラーを回避できるように、このような縮小変換に対してコンパイル時に通知が出されます。詳細については、「暗黙の型変換と明示的な型変換 (Visual Basic)」および「拡大変換と縮小変換 (Visual Basic)」を参照してください。

エラーの原因になる変換には、式の中で発生する暗黙の型変換も含まれます。詳細については、次のトピックを参照してください。

& 演算子 (Visual Basic) を使用して文字列を連結すると、その文字列に対するすべての変換は拡大変換と見なされます。そのような変換では、Option Strict がオンになっている場合でも暗黙の縮小変換エラーは生成されません。

対応するパラメーターとデータ型が異なる引数を持つメソッドを呼び出すと、Option Strict がオンになっている場合は、暗黙の縮小変換によってコンパイル時のエラーが発生します。コンパイル時のエラーを回避するには、拡大変換または明示的な型変換を使用します。

For Each…Next コレクション内の要素からループ制御変数への変換については、コンパイル時の暗黙の縮小変換エラーは出力されません。 Option Strict がオンの場合でも、このエラーは出力されません。詳細については、「For Each...Next ステートメント (Visual Basic)」の「縮小変換」セクションを参照してください。

遅延バインディングエラー

Object 型として宣言された変数のプロパティまたはメソッドに代入されるオブジェクトは、遅延バインディングされます。詳細については、「事前バインディングと遅延バインディング (Visual Basic)」を参照してください。

暗黙のオブジェクト型エラー

宣言された変数の適切な型を推論できず、Object の型が推論された場合、暗黙のオブジェクト型エラーが発生します。このエラーは主に、As 句を使用せずに Dim ステートメントを使用して変数を宣言し、Option Infer が Off である場合に発生します。詳細については、「Option Infer ステートメント」および「Visual Basic 言語仕様」を参照してください。

メソッドのパラメーターでは、Option Strict がオフの場合は As 句は省略可能です。しかし、いずれかのパラメーターが As 句を使用している場合は、すべてのパラメーターがこれを使用する必要があります。 Option Strict がオンの場合、As 句はすべてのパラメーター定義で必須です。

As 句を使用しないで変数を宣言し、それを Nothing に設定した場合、その変数の型は Object になります。 Option Strict がオンで Option Infer もオンの場合、コンパイル時のエラーは発生しません。次に例を示します: Dim something = Nothing

既定のデータ型と値

次の表に、Dim ステートメント (Visual Basic)で、データ型と初期化子をさまざまに組み合わせて指定した場合の結果を示します。

データ型が指定されている	初期化子が指定されている	例	結果
Ｘ	X	Dim qty	Option Strict が Off (既定値) の場合、変数は Nothing に設定されます。 Option Strict が On の場合、コンパイル時のエラーが発生します。
Ｘ	○	Dim qty = 5	Option Infer が On (既定値) の場合、変数は初期化子のデータ型になります。「ローカル型の推論 (Visual Basic)」を参照してください。 Option Infer が Off で、Option Strict が Off の場合、変数は Object のデータ型になります。 Option Infer が Off で、Option Strict が On の場合、コンパイル時のエラーが発生します。
○	Ｘ	Dim qty As Integer	変数は、データ型の既定値に初期化されます。詳細については、「Dim ステートメント (Visual Basic)」を参照してください。
○	○	Dim qty As Integer = 5	初期化子のデータ型が、指定されたデータ型に変換できない場合、コンパイル時のエラーが発生します。

Option Strict ステートメントが存在しない場合

ソースコードに Option Strict ステートメントが含まれていない場合は、[コンパイル] ページ (プロジェクトデザイナー) (Visual Basic) の Option Strict 設定が使用されます。 [コンパイル] ページには、エラーを生成する条件に対するコントロールを追加するための設定があります。

コマンドラインコンパイラを使用する場合は、/optionstrict コンパイラオプションを使用して Option Strictの設定を指定します。

IDE で Option Strict を設定するには

注意

お使いのマシンで、Visual Studio ユーザーインターフェイスの一部の要素の名前や場所が、次の手順とは異なる場合があります。これらの要素は、使用している Visual Studio のエディションや独自の設定によって決まります。詳細については、「Visual Studio の設定」を参照してください。

ソリューションエクスプローラーでプロジェクトを選択します。 [プロジェクト] メニューの [プロパティ] をクリックします。詳細については、「プロジェクトデザイナーの概要」を参照してください。
[コンパイル] タブで、[Option Strict] ボックスの値を設定します。

IDE で警告の構成を設定するには

Option Strict ステートメントの代わりに [コンパイル] ページ (プロジェクトデザイナー) (Visual Basic) を使用すると、エラーを生成する条件に対するコントロールを追加できます。 [コンパイル] ページの [警告の構成] セクションには、Option Strict がオンのときにコンパイル時エラーの原因となる 3 つの条件に対応する設定があります。その 3 つの設定を次に示します。

暗黙の型変換
遅延バインディング (呼び出しは実行時に失敗することがある)
暗黙の型 (想定されるオブジェクト)

[Option Strict] を [On] に設定すると、この 3 つの警告の構成の設定はすべて、[エラー] に設定されます。 [Option Strict] を [Off] に設定すると、これらの設定はすべて、[なし] に設定されます。

警告の構成の設定を、それぞれ個別に [なし]、[警告]、または [エラー] に変更することができます。この 3 つの警告の構成の設定をすべて [エラー] に設定すると、Option strict ボックスに On が表示されます。すべて [なし] に設定すると、このボックスには Off が表示されます。これらの設定を他の組み合わせにした場合は、[(カスタム)] が表示されます。

[Option Strict] の既定の設定を新規プロジェクトに設定するには

プロジェクトを作成するとき、[コンパイル] タブの [Option Strict] 設定は、[オプション] ダイアログボックスの [Option Strict] 設定の内容に設定されます。

このダイアログボックスで Option Strict を設定するには、[ツール] メニューの [オプション] をクリックします。 [オプション] ダイアログボックスで、[プロジェクトおよびソリューション] を展開し、[Visual Basic の既定値] をクリックします。 [Visual Basic の既定値] の既定の初期設定は Off です。

コマンドラインで Option Strict を設定するには

vbc コマンドに /optionstrict コンパイラオプションを指定します。

使用例

暗黙の型変換が縮小変換になるために発生するコンパイル時のエラーの例を次に示します。このエラーのカテゴリは、[コンパイル] ページの [暗黙的な変換] 条件に対応します。

遅延バインディングによるコンパイル時のエラーの例を次に示します。このエラーのカテゴリは、[コンパイル] ページの [遅延バインディング; 呼び出しは実行時に失敗する可能性があります] 条件に対応します。

変数が暗黙的に Object 型指定で宣言されたために発生するコンパイル時のエラーの例を次に示します。このエラーのカテゴリは、[コンパイル] ページの [暗黙的な型; Object と見なされます] 条件に対応します。

参照

履歴の変更

日付

履歴

理由

2011 年 4 月

3 種類の Option Strict エラーについての説明とその例を追加しました。

情報の拡充