次の方法で共有

VSPerfCLREnv

  • [アーティクル]

VSPerfCLREnv ツールが .NET Framework アプリケーションのプロファイリングを行うために必要な環境変数の設定に使用されます。このツールは、次の構文を使います。

VsPerfCLREnv [/option]

選択するオプションは、プロファイルの 3 つの種類 (サンプリング、インストルメンテーション、グローバル) のうち、どれを使用するかによって異なります。プロファイリング データに階層相互作用データを含めるには、別のオプションが必要です。各オプションの構文については、以下の表で説明します。

[!メモ]

プロファイリングが完了したら、/off オプションまたは /globaloff オプションを指定して VSPerfCLREnv を実行し、プロファイリングに必要な環境変数を削除します。詳細については、以下で示される「環境設定を削除するための VSPerfCLREnv オプション」を参照してください。

階層相互作用データを含めるための VSPerfCLREnv オプション

Caution メモ注意

階層の相互作用のプロファイルは Visual Studio Ultimate、Visual Studio Premium、または Visual Studio Professionalを使用して収集できます。ただし、階層の相互作用のプロファイル データが Visual Studio Ultimate と Visual Studio Premiumでのみ表示できます。

階層相互作用のプロファイリングでは、多階層アプリケーションの ADO.NET クエリに関する追加情報が提供されます。データは同期の関数呼び出しについてのみ収集されます。相互作用データは、プロファイリング方式に関係なく、どのプロファイリング実行にも追加できます。

InteractionOn オプションおよび GlobalInteractionOn オプションを使用すると、階層相互作用データを収集できます。相互作用オプションは、アプリケーションのプロファイリングを行うために必要な VSPerfCLREnv 環境変数を設定した後に設定する必要があります。

次の例には、サンプリング方式を使用するプロファイリング実行の階層相互作用データが含まれています。

VSPerfCLREnv /SampleOn
VSPerfCLREnv /InteractionOn
VSPerfCmd /Start:Sample /Output:MyApp.exe.vsp /Launch:MyApp.exe

次の例には、Windows サービスのプロファイリング実行の階層相互作用データが含まれています。

VSPerfCLREnv /GlobalSampleOn
VSPerfCLREnv /GlobalInteractionOn
REM Restart the computer and start the service
VSPerfCmd /Start:Sample /Output:MyService.exe.vsp 
VSPerfCmd /Attach:MyService.exe

プロセス インストルメンテーション プロファイル用の VSPerfCLREnv オプション

次の表を使用して、インストルメンテーション プロファイル用の VSPerfCLREnv オプションについて説明します。

オプション

説明

TraceOn

インストルメンテーション方式を使用したプロファイリングを有効にします。メモリ割り当てプロファイリングまたはオブジェクトの有効期間データの収集は有効にしません。

TraceGC

インストルメンテーション方式を使用したメモリ割り当てプロファイリングを有効にします。オブジェクトの有効期間データの収集は有効にしません。

TraceGCLife

インストルメンテーション方式を使用したメモリ割り当てプロファイリングとオブジェクトの有効期間データの収集を有効にします。

プロセス サンプリング プロファイル用の VSPerfCLREnv オプション

次の表を使用して、サンプリング プロファイル用の VSPerfCLREnv オプションについて説明します。

オプション

説明

SampleOn

サンプリング方式を使用したプロファイリングを有効にします。メモリ割り当てプロファイリングまたはオブジェクトの有効期間データの収集は有効にしません。

SampleGC

サンプリング方式を使用したメモリ割り当てプロファイリングを有効にします。オブジェクトの有効期間データの収集は有効にしません。

SampleGCLife

サンプリング方式を使用したメモリ割り当てプロファイリングを有効にします。オブジェクトの有効期間データの収集も有効にします。

SampleLineOff

.NET 行レベルのプロファイリング データの収集を無効にします。

グローバル プロファイル用の VSPerfCLREnv オプション

ユーザーではなくオペレーティング システムによって起動された ASP.NET Web アプリケーションなどのマネージ サービスのプロファイリングを行うには、グローバル プロファイリング用の VSPerfCLREnv オプションを使用します。グローバル プロファイリング用の VSPerfCLREnv オプションについての説明を次の表に示します。これらのオプションにより、適切な環境変数がレジストリに設定されます。

オプション

説明

GlobalTraceOn

インストルメンテーション方式を使用したグローバル プロファイリングを有効にします。メモリ割り当てイベントまたはオブジェクトの有効期間データは収集しません。

GlobalTraceGC

インストルメンテーション方式を使用したグローバル メモリ割り当てプロファイリングを有効にします。オブジェクトの有効期間データの収集は有効にしません。

GlobalTraceGCLife

インストルメンテーション方式を使用したグローバル メモリ割り当てプロファイリングを有効にします。オブジェクトの有効期間データの収集も有効にします。

GlobalSampleOn

サンプリング方式を使用したグローバル プロファイリングを有効にします。メモリ割り当てイベントまたはオブジェクトの有効期間データの収集は有効にしません。

GlobalSampleGC

サンプリング方式を使用したグローバル メモリ割り当てプロファイリングを有効にします。オブジェクトの有効期間データの収集は有効にしません。

GlobalSampleGCLife

サンプリング方式を使用したグローバル メモリ割り当てプロファイリングを有効にします。オブジェクトの有効期間データの収集も有効にします。

環境設定を削除するための VSPerfCLREnv オプション

マネージ アプリケーションのプロファイリングが完了したら、次のいずれかのオプションを使用して、VSPerfCLREnv で追加した環境変数を削除します。次の表を使用して、標準的な環境変数とグローバル環境変数の両方を削除する方法について説明します。

オプション

説明

Off

標準的な .NET プロファイル用の環境変数を削除します。このオプションは、グローバルではない VSPerfClrEnv オプションを使用してプロファイラー環境変数を設定した場合に使用します。

GlobalOff

グローバルな .NET プロファイル用の環境変数を削除します。プロファイラーではなく、オペレーティング システムによってアプリケーションが起動された場合に、このオプションを使用します。

解説

IDE のパフォーマンス エクスプローラーを使用して起動されたマネージ アプリケーションの場合、アプリケーションのプロファイリングの実行にこれらのオプションは必要ありません。必要なすべての環境変数は、パフォーマンス エクスプローラーによって設定されます。

プロファイリングの実行中に正しい環境が設定されていないと、分析時に警告が報告され、マネージ関数名は正しく解決されません。

参照

概念

コマンド ラインからのプロファイリング ツールの使用