Visual Basic での警告の構成

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

Visual Basic コンパイラには、ランタイムエラーが発生する可能性のあるコードについての一連の警告が用意されています。その情報を使用して、より高速でバグの少ない、すっきりとした優れたコードを作成できます。たとえばユーザーが、未代入のオブジェクト変数のメンバーを呼び出そうとしたり、戻り値を設定せずに関数から制御を戻そうとしたり、例外をキャッチするロジックにエラーがある Try ブロックを実行しようとしたりすると、コンパイラは警告を生成します。

発生が予想されるエラーの心配をすることなく、目的のタスクにユーザーが専念できるように、コンパイラがユーザーの代わりに追加的なロジックを提供することもあります。以前のバージョンの Visual Basic では、Option Strict を使用して、Visual Basic のコンパイラが提供する追加的なロジックを制限していました。警告の構成を使用すると、個々の警告のレベルで、このロジックをよりきめ細かく制御できます。

場合によっては、プロジェクトをカスタマイズして、アプリケーションに無関係な一部の警告をオフにしたり、その他の警告をエラーとして扱うことができます。このページでは、個々の警告をオンおよびオフにする方法を説明します。

警告をオフおよびオンにする

警告を構成するには、2 つの方法があります。それらを構成することができますを使用して、プロジェクトデザイナー、または使用することができます、/warnaserrorと**/nowarn**コンパイラオプション。

[プロジェクトデザイナー] ページの [コンパイル] タブを使用すると、警告をオンおよびオフにできます。すべての警告を無効にするには、[すべての警告を表示しない] チェックボックスをオンにします。すべての警告をエラーとして扱うには、[すべての警告をエラーとして扱う] をオンにします。表示されている表を使用すると、一部の警告をエラーまたは警告として個別に切り替えることができます。

Option Strict を Off に設定した場合、Option Strict に関連する警告をそれぞれ個別に扱うことはできません。 Option Strict を On に設定した場合、関連する警告は、そのステータスにかかわらず、エラーとして扱われます。コマンドラインコンパイラで /optionstrict:custom と指定することによって Option Strict を Custom に設定した場合、Option Strict の警告のオンとオフは個別に切り替えることができます。

また、コンパイラの /warnaserror コマンドラインオプションを使用して、警告をエラーとして扱うかどうかを指定することもできます。このオプションにコンマ区切りのリストを指定し、+ または - を指定すると、警告をエラーと警告のどちらとして扱うかを指定できます。使用可能なオプションの詳細を次の表に示します。

コマンドラインオプション	機能
/warnaserror+	[すべての警告をエラーとして扱う]
/warnsaserror-	警告をエラーとして扱いません。これは、既定の設定です。
/warnaserror+:<warning list>	特定の警告をエラーとして扱います。その対象は、コンマ区切りのリストでエラー ID 番号で指定します。
/warnaserror-:<warning list>	特定の警告をエラーとして扱いません。その対象は、コンマ区切りのリストでエラー ID 番号で指定します。
/nowarn	警告を報告しません。
/nowarn:<warning list>	特定の警告を報告しません。その対象は、コンマ区切りのリストでエラー ID 番号で指定します。

警告リストには、エラーとして扱う警告のエラー ID 番号を指定します。これをコマンドラインオプションで使用して、特定の警告をオンまたはオフにできます。警告リストに無効な番号が含まれている場合、エラーが報告されます。

例

この表は、コマンドライン引数の例と、各引数の動作の説明です。

引数	説明
vbc /warnaserror	すべての警告をエラーとして扱うよう指定しています。
vbc /warnaserror:42024	警告 42024 をエラーとして扱うよう指定しています。
vbc /warnaserror:42024,42025	警告 42024 および 42025 をエラーとして扱うよう指定しています。
vbc /nowarn	警告を一切報告しないよう指定しています。
vbc /nowarn:42024	警告 42024 を報告しないよう指定しています。
vbc /nowarn:42024,42025	警告 42024 および 42025 を報告しないよう指定しています。

警告の種類

次に示すのは、エラーとして扱うのに適している警告の一覧です。

暗黙の型変換の警告

暗黙の型変換のインスタンスに対して生成されます。 & 演算子を使用しているときの、組み込みの数値型から文字列への暗黙の型変換は含まれません。新しいプロジェクトの既定値はオフです。

ID:42016

遅延バインディングによるメソッド呼び出しとオーバーロードの解決の警告

遅延バインディングのインスタンスに対して生成されます。新しいプロジェクトの既定値はオフです。

ID:42017

型オブジェクトのオペランドの警告

Object 型のオペランドがあり、それによって Option Strict On でエラーが発生する場合に生成されます。新しいプロジェクトの既定値はオンです。

ID:42018 と 42019

宣言に 'As' 句が必要との警告

変数、関数、またはプロパティの宣言に As 句がなく、それによって Option Strict On でエラーが発生する場合に生成されます。型が割り当てられていない変数は Object 型と見なされます。新しいプロジェクトの既定値はオンです。

ID:42020 (変数宣言)、42021 (関数宣言)、および 42022 (プロパティ宣言)。

Null 参照の例外の可能性の警告

値を代入する前に変数を使用している場合に生成されます。新しいプロジェクトの既定値はオンです。

ID:42104, 42030

未使用のローカル変数の警告

宣言したローカル変数を 1 度も参照していない場合に生成されます。既定値はオンです。

ID:42024

インスタンス変数から共有メンバーへのアクセスの警告

インスタンスから共有メンバーへアクセスすることで副作用が生じる可能性がある場合、または、インスタンス変数から共有メンバーへのアクセスが式の右側にないか、またはそれをパラメーターとして渡している場合に生成されます。新しいプロジェクトの既定値はオンです。

ID:42025

演算子またはプロパティへの再帰的アクセスの警告

演算子またはプロパティを定義するルーチンの本体で、その演算子またはプロパティ自身を使用している場合に生成されます。新しいプロジェクトの既定値はオンです。

ID:42004 (演算子)、42026 (プロパティ)

戻り値のない関数または演算子の警告

関数または演算子で戻り値を指定していない場合に生成されます。これには、関数と同じ名前を持つ暗黙のローカル変数への Set の省略も含まれます。新しいプロジェクトの既定値はオンです。

ID:42105 (関数)、42016 (演算子)

モジュールでのオーバーロード修飾子の使用の警告

Overloads を Module で使用している場合に生成されます。新しいプロジェクトの既定値はオンです。

ID:42028

Catch ブロックの重複またはオーバーラップの警告

他に定義されている Catch ブロックとの関係で、到達することのない Catch ブロックがある場合に生成されます。新しいプロジェクトの既定値はオンです。

ID:42029, 42031

参照