教程：使用 SQL 数据库在 Azure 中构建 ASP.NET 应用

• 09/03/2018
• 作者
  • 
  • 

Azure Web 应用提供高度可缩放、自修补的 Web 托管服务。 本教程演示如何在 Azure 中部署数据驱动的 ASP.NET Web 应用，以及如何将其连接到 Azure SQL 数据库。 完成本教程后，将拥有在 Azure 中运行并已连接到 SQL 数据库的 ASP.NET 应用。

本教程介绍如何：

如果没有 Azure 订阅，可在开始前创建一个试用帐户。

先决条件

完成本教程：

安装带有 ASP.NET 和 Web 开发工作负荷的 Visual Studio 2017。

如果已安装 Visual Studio，请单击“工具” > Get Tools and Features“获取工具和功能”，以便在 Visual Studio 中添加工作负荷。

下载示例

下载示例项目。

提取（解压缩）dotnet-sqldb-tutorial-master.zip 文件。

此示例项目包含一个使用 Entity Framework Code First 的基本 ASP.NET MVC 创建-读取-更新-删除 (CRUD) 应用。

运行应用程序

在 Visual Studio 中打开 dotnet-sqldb-tutorial-master/DotNetAppSqlDb.sln 文件。

键入 Ctrl+F5，在不调试的情况下运行该应用。 该应用在默认的浏览器中显示。 选择“新建”链接，创建多个待办事项。

测试“编辑”、“详细信息”和“删除”链接。

该应用使用数据库上下文与数据库进行连接。 在此示例中，数据库上下文使用名为 MyDbConnection 的连接字符串。 此连接字符串在 Web.config 文件中设置，在 Models/MyDatabaseContext.cs 文件中引用。 本教程稍后会用到该连接字符串，以便将 Azure Web 应用连接到 Azure SQL 数据库。

使用 SQL 数据库发布到 Azure

在“解决方案资源管理器”中，右键单击 “DotNetAppSqlDb”项目，然后选择“发布”。

确保已选择“Azure 应用服务”，然后单击“发布”。

发布时将打开“创建应用服务”对话框，帮助你创建所需的所有 Azure 资源，以便在 Azure 中运行 ASP.NET Web 应用。

登录 Azure

在“创建应用服务”对话框中单击“添加帐户”，并登录到用户的 Azure 订阅。 如果已登录到 Azure 帐户，请确保该帐户包含 Azure 订阅。 如果登录的 Azure 帐户不包含 Azure 订阅，请单击该帐户添加正确的帐户。

配置 Web 应用名称

可保留生成的 Web 应用名称，或将其更改为另一个唯一名称（有效字符是 a-z、0-9 和 -）。 Web 应用名称将用作应用默认 URL 的一部分（<app_name>.chinacloudsites.cn，其中 <app_name> 是 Web 应用的名称）。 在 Azure 的所有应用中，Web 应用名称必须是唯一的。

创建资源组

资源组是在其中部署和管理 Azure 资源（例如 Web 应用、数据库和存储帐户）的逻辑容器。

在“资源组”旁边单击“新建”。

将资源组命名为 myResourceGroup。

创建应用服务计划

应用服务计划指定托管应用的 Web 服务器场的位置、大小和功能。 可以在托管多个应用时节省资金，方法是将多个 Web 应用配置为共用单个应用服务计划。

应用服务计划定义：

• 区域（例如：中国东部、中国东部 2、中国北部、中国北部 2）
• 实例大小（小、中、大）
• 规模计数（1 到 20 个实例）
• SKU（免费、共享、基本、标准、高级）

在“应用服务计划”旁边单击“新建”。

在“配置应用服务计划”对话框中，使用以下设置配置新的应用服务计划：

创建 SQL Server 实例

在创建数据库之前，需要 Azure SQL 数据库逻辑服务器。 逻辑服务器包含一组作为组管理的数据库。

单击“创建 SQL 数据库”。

在“配置 SQL 数据库”对话框中，单击“SQL Server”旁的“新建”。

此时会生成唯一的服务器名称。 此名称用作逻辑服务器 <server_name>.database.chinacloudapi.cn 的默认 URL 的一部分。 在 Azure 的所有逻辑服务器实例中，它必须是唯一的。 可以更改服务器名称，但就本教程来说，请保留生成的值。

添加管理员用户名和密码。 有关密码复杂性要求，请参阅密码策略。

请记住此用户名和密码。 随后，需要用它们来管理逻辑服务器实例。

单击 “确定”。 尚不要关闭“配置 SQL 数据库”对话框。

创建 SQL 数据库

在“配置 SQL 数据库”对话框中：

• 保留默认生成的数据库名称。
• 在“连接字符串名称”中，键入 MyDbConnection。 此名称必须与 Models/MyDatabaseContext.cs 中引用的连接字符串相匹配。
• 选择“确定” 。

“创建应用服务”对话框显示已配置的资源。 单击创建。

向导在创建完 Azure 资源以后，会将 ASP.NET 应用发布到 Azure。 默认浏览器会使用已部署应用的 URL 启动。

添加多个待办事项。

祝贺！ 数据驱动 ASP.NET 应用程序当前在 Azure 应用服务中实时运行。

本地访问 SQL 数据库

使用 Visual Studio 可在“SQL Server 对象资源管理器”中轻松浏览和管理自己的新 SQL 数据库。

创建数据库连接

在“视图”菜单中，选择“SQL Server 对象资源管理器”。

在“SQL Server 对象资源管理器”顶部，单击“添加 SQL Server”按钮。

配置数据库连接

在“连接”对话框中，展开“Azure”节点。 此处列出了 Azure 中的所有 SQL 数据库实例。

选择先前创建的 SQL 数据库。 底部将自动填充前面创建的连接。

键入先前创建的数据库管理员密码，然后单击“连接”。

允许来自你的计算机的客户端连接

此时会打开“新建防火墙规则”对话框。 默认情况下，SQL 数据库实例仅允许来自 Azure 服务（例如 Azure Web 应用）的连接。 若要连接到数据库，请在 SQL 数据库实例中创建防火墙规则。 防火墙规则允许本地计算机的公共 IP 地址。

对话框中已填充了你的计算机的公共 IP 地址。

请确保选中“添加我的客户端 IP”，然后单击“确定”。

Visual Studio 成功为 SQL 数据库实例创建防火墙设置后，连接将立即显示在“SQL Server 对象资源管理器”中。

可在此处执行最常见的数据库操作，如运行查询、创建视图和存储过程等。

展开连接 >“数据库” > <你的数据库 > > “表”。 右键单击 Todoes 表，然后选择“查看数据”。

使用 Code First 迁移更新应用

可以在 Visual Studio 中使用熟悉的工具，更新 Azure 中的数据库和 Web 应用。 此步骤中将使用实体框架中的 Code First 迁移对数据库架构进行更改，并将其发布至 Azure。

有关使用 Entity Framework Code First 迁移的详细信息，请参阅使用 MVC 5 的 Entity Framework 6 Code First 入门。

更新数据模型

在代码编辑器中打开 Models\Todo.cs。 将以下属性添加到 ToDo 类：

public bool Done { get; set; }

本地运行 Code First 迁移

运行几个命令来更新本地数据库。

在“工具”菜单中，单击“NuGet 包管理器” > “包管理器控制台”。

在“程序包管理器控制台”窗口中，启用“Code First 迁移”：

Enable-Migrations

添加迁移：

Add-Migration AddProperty

更新本地数据库：

Update-Database

键入 Ctrl+F5，以便运行该应用。 测试“编辑”、“详细信息”和“创建”链接。

如果应用程序加载未出错，则 Code First 迁移成功。 但页面看上去仍没有变化，这是因为应用程序逻辑尚未使用新属性。

使用新属性

为了使用 Done 属性，请对代码做一些更改。 简单起见，本教程中将仅更改 Index 和 Create 视图，以便在操作中查看属性。

打开 Controllers\TodosController.cs。

在第 52 行找到 Create() 方法，并将 Done 添加到 Bind 属性中的属性列表。 完成后，Create() 方法签名如以下代码所示：

public ActionResult Create([Bind(Include = "Description,CreatedDate,Done")] Todo todo)

打开 Views\Todos\Create.cshtml。

在 Razor 代码中，应依次看见使用 model.Description 的 <div class="form-group"> 元素和使用 model.CreatedDate 的 <div class="form-group"> 元素。 紧跟在这两个元素之后，添加另一个使用 model.Done 的 <div class="form-group"> 元素：

<div class="form-group">
    @Html.LabelFor(model => model.Done, htmlAttributes: new { @class = "control-label col-md-2" })
    <div class="col-md-10">
        <div class="checkbox">
            @Html.EditorFor(model => model.Done)
            @Html.ValidationMessageFor(model => model.Done, "", new { @class = "text-danger" })
        </div>
    </div>
</div>

打开 Views\Todos\Index.cshtml。

搜索空的 <th></th> 元素。 在此元素的正上方，添加下列 Razor 代码：

<th>
    @Html.DisplayNameFor(model => model.Done)
</th>

查找包含 Html.ActionLink() 帮助器方法的 <td> 元素。 在此 <td> 上面，使用以下 Razor 代码添加另一个 <td> 元素：

<td>
    @Html.DisplayFor(modelItem => item.Done)
</td>

这就是要在 Index 和 Create 视图中查看更改所需的全部操作。

键入 Ctrl+F5 运行应用。

现在可以添加待办事项，然后单击“完成”。 然后，它应作为已完成项在主页中显示。 请记住，Edit视图不显示Done字段，因为没有更改Edit视图。

在 Azure 中启用 Code First 迁移

代码更改生效（包括数据库迁移）后，将其发布至 Azure Web 应用，并仍使用 Code First 迁移更新 SQL 数据库。

与先前的操作相同，右键单击项目，然后选择“发布”。

单击“配置”以打开发布设置。

在向导中，单击“下一步”。

请确保在 MyDatabaseContext (MyDbConnection) 中填充 SQL 数据库的连接字符串。 可能需要从下拉列表中选择“myToDoAppDb”数据库。

选择“执行 Code First 迁移(应用程序启动时运行)”，然后单击“保存”。

发布更改

现已在 Azure Web 应用中启用了 Code First 迁移，请发布代码更改。

在发布页中单击“发布”。

再次尝试添加待办事项并选择“完成”，然后，它们将作为已完成项显示在主页中。

所有现有待办事项仍将显示。 重新发布 ASP.NET 应用程序时，SQL 数据库中的现有数据不会丢失。 此外，Code First 迁移仅更改数据架构，而使现有数据保持不变。

流式传输应用程序日志

可直接通过 Azure Web 应用将跟踪消息流式传输到 Visual Studio。

打开 Controllers\TodosController.cs。

每个操作都以 Trace.WriteLine() 方法开头。 添加此代码的目的是演示如何将跟踪消息添加至 Azure Web 应用。

打开服务器资源管理器

在“视图”菜单中，选择“服务器资源管理器”。 可在“服务器资源管理器”中为 Azure Web 应用配置日志记录。

启用日志流式传输

在“服务器资源管理器”中，展开“Azure” > “应用服务”。

展开“myResourceGroup”资源组，该资源组在首次创建 Azure Web 应用时创建。

右键单击 Azure Web 应用，然后选择“查看流式传输日志”。

现在，日志已流式传输到“输出”窗口。

但还无法查看任何跟踪消息。 因为当首先选择“查看流式传输日志”时，Azure Web 应用将跟踪级别设置为 Error，此级别只记录错误事件（使用 Trace.TraceError() 方法）。

更改跟踪级别

若要更改跟踪级别以输出其他跟踪消息，请返回到“服务器资源管理器”。

再次右键单击 Azure Web 应用并选择“查看设置”。

在“应用程序日志记录(文件系统)”下拉列表中，选择“详细”。 单击“保存” 。

在浏览器中再次导航到 Web 应用（http://<应用名称>.chinacloudsites.cn），然后尝试在 Azure 中的待办事项列表应用程序周围单击。 现在，跟踪消息已流式传输到 Visual Studio 中的“输出”窗口。

Application: 2017-04-06T23:30:41  PID[8132] Verbose     GET /Todos/Index
Application: 2017-04-06T23:30:43  PID[8132] Verbose     GET /Todos/Create
Application: 2017-04-06T23:30:53  PID[8132] Verbose     POST /Todos/Create
Application: 2017-04-06T23:30:54  PID[8132] Verbose     GET /Todos/Index

停止日志流式传输

若要停止日志流式传输服务，请单击“输出”窗口中的“停止监视”按钮。

管理 Azure Web 应用

转到 Azure 门户查看已创建的 Web 应用。

从左侧菜单中单击“应用服务”，并单击 Azure Web 应用的名称。

已进入 Web 应用的页面。

默认情况下，门户将显示“概览”页。 在此页中可以查看应用的运行状况。 在此处还可以执行基本的管理任务，例如浏览、停止、启动、重新启动和删除。 页面左侧的选项卡显示可以打开的不同配置页。

清理资源

在前面的步骤中，在资源组中创建了 Azure 资源。 如果认为将来不需要这些资源，可以通过删除资源组来删除它们。

1. 在 Azure 门户的 Web 应用的“概述”页中，选择“资源组”下的 myResourceGroup 链接。
2. 在资源组页中，确保列出的资源是要删除的资源。
3. 选择“删除”，在文本框中键入 myResourceGroup，然后选择“删除”。

后续步骤

在本教程中，你已学习了如何执行以下操作：