使用 Visual Studio ASP.NET Web 部署：部署代码更新

项目
07/13/2023

本教程系列介绍如何使用 Visual Studio 2012 或 Visual Studio 2010 将 (发布) ASP.NET Web 应用程序部署到Azure 应用服务 Web 应用或第三方托管提供程序。有关该系列的信息，请参阅系列中的第一个教程。

概述

初始部署后，维护和开发网站的工作将继续进行，不久之后，你将需要部署更新。本教程将引导你完成将更新部署到应用程序代码的过程。在本教程中实现和部署的更新不涉及数据库更改;在下一教程中，你将看到部署数据库更改的不同内容。

提醒：如果在完成本教程时收到错误消息或某些内容不起作用，请确保检查故障排除页面。

进行代码更改

作为应用程序更新的简单示例，你将向 “讲师 ”页面添加所选讲师教授的课程列表。

如果运行“ 讲师 ”页，你会注意到网格中有 “选择”链接 ，但它们除了使行背景变为灰色外，不会执行任何其他操作。

包含所选内容的“讲师”页

现在，你将添加在单击 “选择” 链接时运行的代码，并显示所选讲师教授的课程列表。

在 Instructors.aspx 中，紧接在 ErrorMessageLabelLabel 控件后面添加以下标记：

<h3>Courses Taught</h3>
<asp:ObjectDataSource ID="CoursesObjectDataSource" runat="server" TypeName="ContosoUniversity.BLL.SchoolBL"
    DataObjectTypeName="ContosoUniversity.DAL.Course" SelectMethod="GetCoursesByInstructor">
    <SelectParameters>
        <asp:ControlParameter ControlID="InstructorsGridView" Name="PersonID" PropertyName="SelectedDataKey.Value"
            Type="Int32" />
    </SelectParameters>
</asp:ObjectDataSource>
<asp:GridView ID="CoursesGridView" runat="server" DataSourceID="CoursesObjectDataSource"
    AllowSorting="True" AutoGenerateColumns="False" SelectedRowStyle-BackColor="LightGray"
    DataKeyNames="CourseID">
    <EmptyDataTemplate>
        <p>No courses found.</p>
    </EmptyDataTemplate>
    <Columns>
        <asp:BoundField DataField="CourseID" HeaderText="ID" ReadOnly="True" SortExpression="CourseID" />
        <asp:BoundField DataField="Title" HeaderText="Title" SortExpression="Title" />
        <asp:TemplateField HeaderText="Department" SortExpression="DepartmentID">
            <ItemTemplate>
                <asp:Label ID="GridViewDepartmentLabel" runat="server" Text='<%# Eval("Department.Name") %>'></asp:Label>
            </ItemTemplate>
        </asp:TemplateField>
    </Columns>
</asp:GridView>

运行页面并选择讲师。你会看到该讲师教授的课程列表。
关闭浏览器。

将代码更新部署到测试环境

需要更改数据库发布选项，然后才能使用发布配置文件部署到测试、暂存和生产。不再需要为成员资格数据库运行授权和数据部署脚本。

右键单击 ContosoUniversity 项目并单击“发布”，打开“发布Web”向导。
单击“配置文件”下拉列表中的“测试配置文件”。
单击“设置”选项卡。
在“数据库”部分中的“DefaultConnection”下，清除“更新数据库检查”框。
单击“配置文件”选项卡，然后单击“配置文件”下拉列表中的“暂存配置文件”。
当系统询问是否要保存对测试配置文件所做的更改时，单击“ 是”。
在暂存配置文件中执行相同的更改。
重复此过程，在生产配置文件中执行相同的更改。
关闭 “发布 Web” 向导。

部署到测试环境现在只需再次运行一键发布即可。若要加快此过程，可以使用 Web 一键发布 工具栏。

在“ 视图 ”菜单中，选择“ 工具栏 ”，然后选择“ Web 一键发布”。
在“解决方案资源管理器”中，选择“ContosoUniversity”项目。
单击 “Web 一键发布 ”工具栏，选择“ 测试发布”配置文件，然后单击“ 发布 Web ” (箭头指向左右) 的图标。
Visual Studio 部署更新的应用程序，浏览器会自动打开到主页。
运行“讲师”页并选择一个讲师以验证是否已成功部署更新。

通常还会执行回归测试 (即测试站点的其余部分，以确保新更改不会破坏) 的任何现有功能。但在本教程中，你将跳过该步骤，继续将更新部署到过渡和生产环境。

重新部署时，Web 部署会自动确定哪些文件已更改，并且仅将更改的文件复制到服务器。默认情况下，Web 部署对文件使用上次更改的日期来确定哪些日期已更改。即使你不更改文件内容，某些源代码管理系统也会更改文件日期。在这种情况下，可能需要将 Web 部署配置为使用文件校验和来确定哪些文件已更改。有关详细信息，请参阅 ASP.NET 部署常见问题解答中的为何重新部署所有文件（尽管我未更改它们？）。

在部署期间使应用程序脱机

现在要部署的更改是对单个页面的简单更改。但有时，部署更大的更改，或者部署代码和数据库更改，如果用户在部署完成之前请求页面，站点的行为可能会不正确。若要防止用户在部署过程中访问站点，可以使用 app_offline.htm 文件。将名为 app_offline.htm 的文件放入应用程序的根文件夹中时，IIS 会自动显示该文件，而不是运行应用程序。因此，若要防止在部署期间访问，请将 app_offline.htm 放入根文件夹中，运行部署过程，然后在成功部署后删除 app_offline.htm 。

可以将 Web 部署配置为在服务器开始部署时自动将默认 app_offline.htm 文件放在服务器上，并在部署完成后将其删除。要执行此操作，只需将以下 XML 元素添加到发布配置文件 (.pubxml) 文件：

<EnableMSDeployAppOffline>true</EnableMSDeployAppOffline>

本教程介绍如何创建和使用自定义 app_offline.htm 文件。

不需要在过渡站点中使用 app_offline.htm ，因为没有访问过渡站点的用户。但最好使用过渡来测试计划部署在生产环境中的所有内容。

创建app_offline.htm

在“解决方案资源管理器”中，右键单击解决方案，单击“添加”，然后单击“新建项”。
创建名为 app_offline.htm 的 HTML 页面， (删除 Visual Studio 默认创建的.html扩展) 的最后一个“l”。

将模板标记替换为以下标记：

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
    <title>Contoso University - Under Construction</title>
</head>
<body>
  <h1>Contoso University</h1>
  <h2>Under Construction</h2>
  <p>The Contoso University site is temporarily unavailable while we upgrade it. Please try again later.</p>
</body>
</html>

保存并关闭该文件。

将app_offline.htm复制到网站的根文件夹

可以使用任何 FTP 工具将文件复制到网站。 FileZilla 是一种常用的 FTP 工具，显示在屏幕截图中。

若要使用 FTP 工具，需要三项内容：FTP URL、用户名和密码。

URL 显示在 Azure 管理门户的网站仪表板页上，FTP 的用户名和密码可以在之前下载的 .publishsettings 文件中找到。以下步骤演示如何获取这些值。

在 Azure 管理门户中，单击“ 网站 ”选项卡，然后单击过渡网站。
在 “仪表板 ”页上，向下滚动以在 “快速概览 ”部分中找到 FTP 主机名。
在记事本或其他文本编辑器中打开暂存 .publishsettings 文件。
publishProfile查找 FTP 配置文件的元素。
userName复制和 userPWD 值。
打开 FTP 工具并登录到 FTP URL。
将 app_offline.htm 从解决方案文件夹复制到暂存站点中的 /site/wwwroot 文件夹。
浏览到过渡站点的 URL。你会看到现在显示 app_offline.htm 页，而不是主页。

现在已准备好部署到过渡。

将代码更新部署到过渡和生产

在 “Web 一键发布 ”工具栏中，选择 “暂存 发布”配置文件，然后单击“ 发布 Web”。

Visual Studio 部署更新的应用程序，并将浏览器打开到站点主页。将显示 app_offline.htm 文件。必须先删除 app_offline.htm 文件，然后才能进行测试以验证部署成功。
返回到 FTP 工具，并从过渡站点中删除 app_offline.htm 。
在浏览器中，打开过渡站点中的“讲师”页，并选择一个讲师以验证是否已成功部署更新。
请遵循与过渡相同的生产过程。

查看更改和部署特定文件

Visual Studio 2012 还支持部署单个文件。对于所选文件，可以查看本地版本与已部署版本之间的差异，将文件部署到目标环境，或将文件从目标环境复制到本地项目。本教程的此部分介绍如何使用这些功能。

更改部署

打开 Content/Site.css，并找到标记的 body 块。

将的值 background-color 从 #fff 更改为 darkblue。

body {
    background-color: darkblue;
    border-top: solid 10px #000;
    color: #333;
    font-size: .85em;
    font-family: "Segoe UI", Verdana, Helvetica, Sans-Serif;
    margin: 0;
    padding: 0;
}

在“发布预览”窗口中查看更改

使用 “发布 Web” 向导发布项目时，可以通过双击 “预览” 窗口中的文件来查看要发布的更改。

右键单击 ContosoUniversity 项目，然后单击“ 发布”。
从 “配置文件” 下拉列表中，选择“ 测试发布配置文件”。
单击“ 预览”，然后单击“ 开始预览”。
在 “预览 ”窗格中，双击“ Site.css”。

“ 预览更改 ”对话框显示将部署的更改的预览。

如果双击 Web.config 文件，“ 预览更改 ”对话框将显示生成配置转换和发布配置文件转换的效果。此时，尚未执行任何会导致服务器上的 Web.config 文件发生更改，因此预计不会看到任何更改。但是， “预览更改 ”窗口错误地显示两个更改。看起来将删除两个 XML 元素。在应用程序启动时为 Code First 上下文类选择“执行Code First 迁移”时，发布进程会添加这些元素。比较是在发布过程添加这些元素之前完成的，因此看起来它们已被删除，尽管它们不会被删除。此错误将在将来的版本中更正。
单击“关闭”。
单击“发布” 。
当浏览器打开到测试网站的主页时，按 Ctrl+F5 进行硬刷新，以查看 CSS 更改的效果。
关闭浏览器。

从解决方案资源管理器发布特定文件

假设你不喜欢蓝色背景，想要还原原始颜色。在本部分中，你将通过直接从 解决方案资源管理器 发布特定文件来还原原始设置。

打开 Content/Site.css 并将 background-color 设置还原到 #fff。
在 解决方案资源管理器 中，右键单击 Content/Site.css 文件。

上下文菜单显示三个发布选项。
单击“ 预览对 Site.css 的更改”。

此时会打开一个窗口，显示本地文件与目标环境中的版本之间的差异。
在“解决方案资源管理器”中，再次右键单击“Site.css”，然后单击“发布 Site.css”。

“ Web 发布活动” 窗口显示文件已发布。
打开指向 URL 的 http://localhost/contosouniversity 浏览器，然后按 Ctrl+F5 进行硬刷新，以查看 CSS 更改的效果。
关闭浏览器。