通过

如何：修改 Web.Config 文件以检测和分析动态编译的 ASP.NET Web 应用程序

  • 项目

使用 Visual Studio 分析工具检测方法，可以从动态编译的 ASP.NET Web 应用程序收集详细计时数据、.NET 内存分配数据和 .NET 对象生存期数据。

本主题介绍如何修改 web.config 配置文件才能检测和分析 ASP.NET Web 应用程序。

提示

使用采样分析方法时或要检测预编译的 ASP.NET 模块时，不必修改 web.config 文件。

web.config 文件的根元素为 configuration 元素。 若要检测和分析动态编译的 ASP.NET Web 应用程序，必须添加或修改以下元素：

  • configuration/runtime/assemblyBinding/dependentAssembly 元素，它标识控制分析的 Microsoft.VisualStudio.Enterprise.ASPNetHelper 程序集。 dependentAssembly 元素包含两个子元素：assemblyIdentity 和 codeBase。

  • configuration/system.web/compilation 元素，标识目标程序集的探查器处理后编译步骤。

  • 标识分析工具位置的两个 add 元素将被添加到 configuration/appSettings 节。

我们建议您创建原始 web.config 文件的副本，该副本可用于还原应用程序的配置。

添加 ASPNetHelper 程序集作为 configuration/runtime/assemblyBinding/dependentAssembly 元素

  1. 如有必要，请添加 runtime 元素作为 configuration 元素的子元素；否则，请转到下一步。

    runtime 元素没有任何特性。 configuration 元素只能具有一个 runtime 子元素。

  2. 如有必要，请添加 assemblyBinding 元素作为 runtime 元素的子元素；否则，请转到下一步。

    runtime 元素只能具有一个 assemblyBinding 元素。

  3. 将下列特性名称和值添加到 assemblyBinding 元素：

    特性名

    特性值

    Xmlns

    urn:schemas-microsoft-com:asm.v1

  4. 添加 dependentAssembly 元素作为 assemblyBinding 元素的子元素。

    dependentAssembly 元素没有任何特性。

  5. 添加 assemblyIdentity 元素作为 dependentAssembly 元素的子元素。

  6. 将下列特性名和值添加到 assemblyIdentity 元素：

    特性名

    特性值

    name

    Microsoft.VisualStudio.Enterprise.ASPNetHelper

    PublicKeyToken

    b03f5f7f11d50a3a

    culture

    Neutral

  7. 添加 codeBase 元素作为 dependentAssembly 元素的子元素。

  8. 将下列特性名称和值添加到 codeBase 元素：

    特性名

    特性值

    version

    10.0.0.0

    href

    PathToASPNetHelperDll

    PathToASPNetHelperDll 是 Microsoft.VisualStudio.Enterprise.ASPNetHelper.dll 的文件 URL。 如果 Visual Studio 安装在默认位置，则 href 值应为 C:/Program%20Files/Microsoft%20Visual%20Studio%202010.0/Common7/IDE/PrivateAssemblies/Microsoft.VisualStudio.Enterprise.ASPNetHelper.DLL

    <configuration>
        <runtime>
            <assemblyBinding 
                xmlns="urn:schemas-microsoft-com:asm.v1"
            >
                <dependentAssembly>
                    <assemblyIdentity                         name="Microsoft.VisualStudio.Enterprise.ASPNetHelper" 
                        publicKeyToken="b03f5f7f11d50a3a"                         culture="neutral" 
                    />
                    <codeBase 
                        version="10.0.0.0"
                        href="file:///C:/Program%20Files/Microsoft%20Visual%20Studio%2010.0/Common7/IDE/PrivateAssemblies/Microsoft.VisualStudio.Enterprise.ASPNetHelper.DLL" 
                    />
                </dependentAssembly>
            </assemblyBinding>
        </runtime>

将探查器后续处理步骤添加到 configuration/system.web/compilation 元素

  1. 如有必要，请添加 system.web 元素作为 configuration 元素的子元素；否则，请转到下一步。

    system.web 元素没有任何特性。 configuration 元素只能具有一个 system.web 子元素。

  2. 如有必要，请添加 compilation 元素作为 system.web 元素的子元素；否则，请转到下一步。

    system.web 元素只能具有一个 compilation 子元素。

  3. 从 compilation 元素移除任何现有特性，并添加以下特性名和值：

    特性名

    特性值

    assemblyPostProcessorType

    Microsoft.VisualStudio.Enterprise.Common.AspPerformanceInstrumenter, Microsoft.VisualStudio.Enterprise.ASPNetHelper, Version=10.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a

    		 
    <configuration>
        <runtime>
        . . .
        </runtime>
        <system.web>
            <compilation
                assemblyPostProcessorType="Microsoft.VisualStudio.Enterprise.Common.AspPerformanceInstrumenter,
                    Microsoft.VisualStudio.Enterprise.ASPNetHelper,
                    Version=10.0.0.0,
                    Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" 
            />
        </system.web>
    <configuration>

将探查器位置设置添加到 configuration/appSettings 元素

  1. 如有必要，请添加 appSettings 元素作为 configuration 元素的子元素；否则，请转到下一步。

    appSettings 元素没有任何特性。 configuration 元素只能具有一个 appSettings 子元素。

  2. 添加 add 元素作为 appSettings 元素的子元素。

  3. 将下列特性名和值添加到 add 元素：

    特性名

    特性值

    key

    Microsoft.VisualStudio.Enterprise.AspNetHelper.VsInstrLocation

    value

    PerformanceToolsFolder\VSInstr.Exe

  4. 添加另一个 add 元素作为 appSettings 元素的子元素。

  5. 将下列特性名称和值添加到此 add 元素：

    特性名

    特性值

    key

    Microsoft.VisualStudio.Enterprise.AspNetHelper.VsInstrTools

    value

    PerformanceToolsFolder

    PerformanceToolsFolder 是探查器可执行文件的路径。 如果 Visual Studio 安装在默认位置，则该值将为 C:\Program Files\Microsoft Visual Studio 10.0\Team Tools\Performance Tools

    <configuration>
        <runtime>
        . . .
        </runtime>
        . . .
        <system.web>
        </system.web>
        <appSettings>
            <add
                key="Microsoft.VisualStudio.Enterprise.AspNetHelper.VsInstrLocation"
                value="C:\Program Files\Microsoft Visual Studio 10.0\Team Tools\Performance Tools\vsinstr.exe"
        />
            <add
                key="Microsoft.VisualStudio.Enterprise.AspNetHelper.VsInstrTools"
                value="C:\Program Files\Microsoft Visual Studio 10.0\Team Tools\Performance Tools\"
            />
        </appSettings>
    </configuration>

示例

下面是一个完整的 web.config 文件，该文件允许检测和分析动态编译的 ASP.NET Web 应用程序。 此示例假定修改前文件中没有其他设置。

<?xml version="1.0"?>
    <configuration>
        <runtime>
            <assemblyBinding 
                xmlns="urn:schemas-microsoft-com:asm.v1"
            >
                <dependentAssembly>
                    <assemblyIdentity 
                        name="Microsoft.VisualStudio.Enterprise.ASPNetHelper" 
                        publicKeyToken="b03f5f7f11d50a3a"
                        culture="neutral" 
                    />
                    <codeBase 
                        version="10.0.0.0"
                        href="file:///C:/Program%20Files/Microsoft%20Visual%20Studio%2010.0/Common7/IDE/PrivateAssemblies/Microsoft.VisualStudio.Enterprise.ASPNetHelper.DLL" 
                    />
                </dependentAssembly>
            </assemblyBinding>
        </runtime>
        <system.web>
            <compilation
                assemblyPostProcessorType="Microsoft.VisualStudio.Enterprise.Common.AspPerformanceInstrumenter,
                    Microsoft.VisualStudio.Enterprise.ASPNetHelper,
                    Version=10.0.0.0,
                    Culture=neutral,
                    PublicKeyToken=b03f5f7f11d50a3a" 
            />
        </system.web>
        <appSettings>
            <add
                key="Microsoft.VisualStudio.Enterprise.AspNetHelper.VsInstrLocation"
                value="C:\Program Files\Microsoft Visual Studio 10.0\Team Tools\Performance Tools\vsinstr.exe"
            />
            <add
                key="Microsoft.VisualStudio.Enterprise.AspNetHelper.VsInstrTools"
                value="C:\Program Files\Microsoft Visual Studio 10.0\Team Tools\Performance Tools\"
            />
        </appSettings>
    </configuration>

请参见

任务

如何：使用命令行通过探查器检测动态编译的 ASP.NET Web 应用程序并收集详细计时数据

如何：使用探查器命令行检测动态编译的 ASP.NET Web 应用程序并收集内存数据