HOW TO：從命令列將階層互動資料加入至程式碼剖析資料

發行項
08/12/2011

階層互動分析會提供有關多介層應用程式函式中與一個或多個資料庫通訊之同步 ADO.NET 呼叫的執行時間額外資訊。您可以使用任何程式碼剖析方法來收集階層互動資料。

注意事項
階層互動資料只能在 Visual Studio IDE 中檢視。透過 VSPerfReport 的檔案架構階層互動報表無法使用。

使用 VSPerfASPNETCmd 加入階層互動資料

VSPerfASPNETCmd 命令列工具可讓您對 ASP.NET Web 應用程式輕鬆進行程式碼剖析。相較於 VSPerfCmd 命令列工具，選項減少、不必設定環境變數，也不需要重新啟動電腦。這些 VSPerfASPNETCmd 功能會讓階層互動資料收集意外地輕鬆。

若要透過 VSPerfASPNETCmd 將階層互動加入至收集的程式碼剖析資料，請在命令列上加入 /TIP 選項。例如，當您使用取樣方法收集 ASP.NET Web 應用程式的應用程式統計資料時，使用下列命令列工具以包含階層互動資料：

vsperfaspnetcmd /tip https://localhost/MyWebApp

如需 VSPerfASPNETCmd 的詳細資訊，請參閱使用 VSPerfASPNETCmd 快速進行網站程式碼剖析。

使用 VSPerfCmd 加入階層互動資料

VSPerfASPNETCmd 命令列工具可讓您存取程式碼剖析工具的完整功能。若要透過 VSPerfCmd 將階層互動加入至收集的程式碼剖析資料，您必須使用 VSPerfCLREnv 公用程式，設定及移除啟用階層互動資料的環境變數。您所指定的選項以及收集資料的所需程序取決於要進行程式碼剖析的應用程式類型。

對獨立應用程式進行程式碼剖析

若要將階層互動資料加入至另一個處理序未執行的應用程式，例如對 SQLServer 資料庫發出同步 ADO.NET 呼叫的 Windows 桌面應用程式，請使用 VSPerfClrEnv /InteractionOn 選項設定環境變數，並使用 VSPerfClrEnv /InteractionOff 選項移除它們。

在下列範例中，使用取樣方法，對 Windows 桌面應用程式進行程式碼剖析執行，而且收集階層互動資料。

Windows 桌面應用程式的程式碼剖析範例

使用系統管理員權限來開啟命令提示字元視窗。按一下 [開始]，指向 [所有程式]，然後指向 [附屬應用程式]。以滑鼠右鍵按一下 [命令提示字元]，然後按一下 [以系統管理員身分執行]。
初始化 TIP 環境變數。輸入下列命令：
```
vsperfclrenv /interactionon
```

啟動程式碼剖析工具。輸入下列命令：

vsperfcmd /start:sample /output:Desktop_sample.vsp

使用 VSPerfCmd 啟動應用程式。輸入下列命令：
```
vsperfcmd /launch:DesktopApp.exe
```
執行應用程式以收集程式碼剖析資料，然後以正常方式關閉應用程式。
清除 TIP 環境變數。輸入下列命令：
```
vsperfclrenv /off
```

如需詳細資訊，請參閱獨立應用程式的命令列分析。

對服務進行程式碼剖析

若要對服務 (包括 ASP.NET 應用程式) 進行程式碼剖析，請使用 VSPerfClrEnv /GlobalInteractionOn 選項設定環境變數，並且使用 VSPerfClrEnv /GlobalInteractionOff 選項移除它們。

對服務 (包括 ASP.NET Web 應用程式) 進行程式碼剖析時，通常會需要重新啟動電腦，才能啟用程式碼剖析。

在下列範例中，使用取樣方法，對 Windows 服務進行程式碼剖析執行，而且收集階層互動資料。

Windows 服務的程式碼剖析範例

如有必要，請安裝服務。
使用系統管理員權限來開啟命令提示字元視窗。按一下 [開始]，指向 [所有程式]，然後指向 [附屬應用程式]。以滑鼠右鍵按一下 [命令提示字元]，然後按一下 [以系統管理員身分執行]。
初始化 .NET 程式碼剖析環境變數。輸入下列命令：
```
vsperfclrenv /globalsampleon
```
初始化 TIP 環境變數。輸入下列命令：
```
vsperfclrenv /globalinteractionon
```
重新啟動電腦以註冊環境變數。
使用系統管理員權限來開啟命令提示字元視窗。

啟動程式碼剖析工具。輸入下列命令：

vsperfcmd /start:sample /output:MiddleTier_sample.vsp /user:SYSTEM /crosssession

如有必要，請啟動服務。

將程式碼剖析工具附加到服務。輸入下列命令：

vsperfcmd /attach:MiddleTier.exe /output:MyService_sample.vsp /user:SYSTEM /crosssession

執行服務並收集程式碼剖析資料。
停止分析工具。輸入下列命令：

vsperfcmd /detach
清除 .NET 和 TIP 程式碼剖析環境變數。輸入下列命令：
```
vsperfclrenv /globaloff
```
重新啟動電腦以註冊清除的環境變數。

如需詳細資訊，請參閱下列其中一個主題：

ASP.NET Web 應用程式的命令列分析

服務的命令列分析

共用方式為