教學課程：開始在 ASP.NET MVC Web 應用程式中使用 EF Core

接下來您會為 Contoso 大學應用程式建立實體類別。 您會從下列三個實體開始。

You will then create an entity category for the Contoso University application. You will start with the following three entities.

在 和 實體之間存在一對多關聯性， 與 實體之間也存在一對多關聯性。 換句話說，一位學生可以註冊並參加任何數目的課程，而一個課程也可以有任何數目的學生註冊。

In other words, a student can register and attend classes for any number of purposes, while a student can register for any number of purposes.

在下節中，您會為這些實體建立各自的類別。

In the next section, you will create categories for these entities.

在 [Models] 資料夾中，建立一個名為 的類別檔案，然後使用下列程式碼取代範本程式碼。

Creates a class file in the [Models] folder and replaces the template code with the following code.

屬性會成為資料庫資料表中的主索引鍵資料行，並對應至這個類別。 Entity Framework 預設會將名為 或 的屬性解譯為主索引鍵。

Properties will become the main index key data line in the database database and correspond to this category. Entity Framewerk defaults to interpret properties by name or by name as the main index key.

在 [Models] 資料夾中，建立 ，然後使用下列程式碼取代現有的程式碼：

Create in [Models] folder and then replace the existing code with the following code:

屬性為 。 問號之後的 類型宣告表示 屬性可為 Null。 為 Null 的成績不同於成績為零：Null 表示成績未知或尚未指派。

Properties are. The type of declaration after the question mark indicates that properties can be Null. The result for Null is different from the score of zero: Null means that grades are unknown or have not been assigned.

屬性是外部索引鍵，對應的導覽屬性是 。 實體與一個 實體關聯，因此屬性僅能保有單一 實體 (不像您先前看到的 導覽屬性可保有多個 實體)。

Properties are external index keys and the guide properties are. The entity is associated with an entity, so the attribute can only hold a single entity (not as many entities as you have seen before).

屬性是外部索引鍵，對應的導覽屬性是 。 一個 實體與一個 實體建立關聯。

Properties are external index keys, and the corresponding navigational properties are. An entity is associated with an entity.

Entity Framework 會將名為 的屬性解譯為外部索引鍵屬性 (例如 導覽屬性的 ，因為 實體的主索引鍵為 )。 外部索引鍵屬性也可以簡單的命名為 (例如 ，因為 實體的主索引鍵為 )。

Entity Framewerk interprets the attribute name as an external index key attribute (e. g. guide property because the entity's main index key is). The external index key attribute can also be simply named (e. g. because the entity's main index key is).

在 [Models] 資料夾中，建立 ，然後使用下列程式碼取代現有的程式碼：

Create in [Models] folder and then replace the existing code with the following code:

屬性為導覽屬性。 實體可以與任何數量的 實體相關。

Properties are navigation properties. An entity can be associated with any number of entities.

為指定資料模型協調 Entity Framework 功能的主要類別便是資料庫內容類別。 若要建立此類別，您可以從 類別來衍生。 在您的程式碼中，您會指定資料模型中包含哪些實體。 您也可以自訂某些 Entity Framework 行為。 在此專案中，類別命名為 。

The main category for the specified data model function is the database content class. To create this category, you can derive from the category. In your code, you specify which entities are included in the data model. You can also customize some Entity Framewerk behaviors. In this case, the category is named.

在專案資料夾中，建立名為 Data 的資料夾。

Creates a folder in the project folder named Data.

在 [Data] 資料夾中，建立名為 的新類別檔案，然後使用下列程式碼取代範本程式碼：

In the [Data] folder, create a new type of file named, and then replace the template code with the following code:

程式碼會為每一個實體集建立 屬性。 在 Entity Framework 詞彙中，實體集通常會對應至資料庫資料表，而實體則對應至資料表中的資料列。

Codes create attributes for each set of entities. In the Entity Framewerk vocabulary, the collection usually corresponds to the database data sheet, while the entity corresponds to the data column in the data sheet.

您可以省略 及 陳述式，其結果也會是相同的。 Entity Framework 會隱含它們，因為 實體參考了 實體；而 實體參考了 實體。

You can omit and make statements, and the results will be the same. Entity Framewerk will cover them because the entity refers to the entity; the entity refers to the entity.

資料庫建立時，EF 會建立和 屬性名稱相同的資料表。 集合的屬性名稱通常都是複數 (Students 而非 Student)，但許多開發人員會為了資料表名稱究竟是否該是複數型態而爭論。 在此系列教學課程中，您會藉由指定 DbContext 中的單數資料表名稱來覆寫預設行為。 若要完成這項操作，請在最後一個 DbSet 屬性後方新增下列醒目提示程式碼。

When the database is created, the EF will create the same datasheet as the property name. The property name of the collection is usually a complex number (Students rather than Student), but many developers will argue whether or not the name of the table should be a complex type. In this series, you will overwrite the default behaviour by specifying the name of the singular data sheet in DbContext. To do this, add the following sharp hint code after the last DbSet attribute.

建置專案以檢查編譯器錯誤。

Build project to check compiler error.

若要將 註冊為服務，請開啟 ，並將醒目標示的程式碼新增至 方法。

To register as service, open and add the Awakening Target code to the method.

為 和 命名空間新增 陳述式，然後建置專案。

Adds a statement for the space and name, and then builds the project.

開啟 檔案並新增連接字串，如下列範例所示。

Opens the file and adds a new connection string, as shown in the examples below.

連接字串會指定 SQL Server LocalDB 資料庫。 LocalDB 是輕量版的 SQL Server Express Database Engine，旨在用於應用程式開發，而不是生產用途。 LocalDB 會依需求啟動，並以使用者模式執行，因此沒有複雜的組態。 LocalDB 預設會在 目錄中建立 .mdf 資料庫檔案。

The connection string specifies the SQL Server LocalDB database. The LocalDB is a light version of SQL Server Express Database Engineering, designed to be developed for application purposes rather than for production purposes. The LocalDB is demand-driven and executed in user mode, so there is no complex configuration. The LocalDB default will create a database file in the directory .mdf.

Entity Framework 會為您建立空白資料庫。 在本節中，您會撰寫一個方法，該方法會在資料庫建立之後呼叫，以將測試資料填入資料庫。

Entity Framewerk will create an empty database for you. In this section you will write a method that will be called when the database is in place to fill the test data in the database.

在 [Data] 資料夾中，建立一個名為 的新類別檔案，使用下列程式碼取代範本程式碼。這些程式碼會在需要的時候建立資料庫，並將測試資料載入至新的資料庫。

Creates a new type of file in the [Data] folder, replacing the template code with the following code. These codes create a database when needed and load the test data into the new database.

程式碼會檢查資料庫中是否有任何學生。若沒有的話，它便會假設資料庫是新的資料庫，因此需要植入測試資料。 會將測試資料載入至陣列而非 集合，以最佳化效能。

The code will check whether there are any students in the database. If it does not, it will assume that the database is a new database, and therefore the test data will need to be installed. The test data will be loaded into the array instead of the collection to optimize efficiency.

在 中，修改 方法來在應用程式啟動期間執行下列動作：

In, modify method to execute the following actions during application startup:

• 從相依性插入容器中取得資料庫內容執行個體。
• 呼叫種子方法，並將其傳遞給內容。
• 種子方法完成時處理內容。

在您首次執行應用程式時，資料庫便會建立並植入測試資料。 每當您變更資料模型時：

When you run an application for the first time, the database builds and implants the test data. Every time you change the data model:

• 刪除資料庫。
• 更新種子方法，並使用相同方法以新的資料庫重新開始。

在稍後的教學課程中，您會了解如何在資料模型變更時修改資料庫，而不需要刪除和重新建立它。

Later in the course, you will learn how to modify the database when the data model changes, without the need to delete and recreate it.

在本節中，我們將會使用 Visual Studio 中的 Scaffolding 引擎來新增使用 EF 查詢和儲存資料的 MVC 控制器及檢視。

In this section, we will use the Scaffolding engine in Visual Studio to add a new MVC controller and view using EF query and data storage.

自動建立 CRUD 動作方法和檢視稱為 Scaffolding。 Scaffolding 與產生程式碼不同。Scaffold 程式碼是一個開始點，使得您可以修改它以符合您的需求，然而您通常不會去修改產生的程式碼。 當您需要自訂產生的程式碼時，您會使用部分類別，或者您會在事務變更時重新產生程式碼。

Automatically create the CRUD action method and view it as Scaffolding. Scaffolding is different from generating the code. The Scaffold code is a starting point that allows you to modify it to suit your needs, but you do not usually change the resulting code. When you need to customize the code, you will use some of the different types, or you will recreate the code when the matter changes.

• 以滑鼠右鍵按一下 [方案總管] 中的 [Controllers] 資料夾，然後選取 [新增] > [新增 Scaffold 項目]。
• 在 [新增 Scaffold] 對話方塊中：
  • 選取 [使用 Entity Framework 執行檢視的 MVC 控制器]。
  • 按一下新增。 [新增使用 Entity Framework 執行檢視的 MVC 控制器] 對話方塊隨即出現：
  • 在 [模型類別] 中，選取 [Student]。
  • 在 [資料內容類別] 中，選取 [SchoolContext]。
  • 接受預設的 StudentsController 作為名稱。
  • 按一下新增。

Visual Studio Scaffolding 引擎會建立 檔案及一組可以使用該控制器的檢視 ( 檔案)。

The Visual Studio Scaffolding engine will create files and a set of views (files) that can use the controller.

請注意，控制器會接受 作為建構函式的參數。

Please note that the controller will accept as a construction function parameter.

ASP.NET Core 相依性插入會負責傳遞 的執行個體給控制器。 該項已在 檔案中設定。

ASP.NET Core Dependency Inserts an executable individual to controller that will be responsible for transmission. This is set in the file.

控制器含有一個 動作方法，該方法會顯示資料庫中的所有學生。 方法會藉由讀取資料庫內容執行個體的 屬性，來從 Students 實體集中取得學生的清單：

The controller contains an action method that shows all students in the database. The method is to get a list of students from the Stuarts entity by reading the properties of the database contents:

您會在教學課程的稍後學習到此程式碼中的非同步程式設計項目。

You will learn about non-synchronous program design items in this code later in the course.

檢視會在資料表中顯示此清單：

The view will show this list in the table:

按 CTRL+F5 來執行專案，或從功能表選擇 [偵錯] > [啟動但不偵錯]。

Press CTRL+F5 to execute the project, or select & gt from the functional table; [started but not detected] .

按一下 [Students] 索引標籤來查看 方法插入的測試資料。 取決於您瀏覽器視窗的寬度，您可能會在頁面的頂端看到 索引標籤連結，或是按一下位於右上角的導覽圖示來查看連結。

Click the [Students] index label to see the test data inserted by the method. Depending on the width of your browser window, you may see the link at the top of the page or the link at the top right-hand corner.

當您啟動應用程式時， 方法會呼叫 。 EF 看到不存在任何資料庫，於是便建立了一個資料庫，接著 方法程式碼的剩餘部分便會將資料填入資料庫。 您可以使用 [SQL Server 物件總管 (SSOX) 來在 Visual Studio 中檢視資料庫。

When you start the application, the method calls. If you see that there is no database, the EF has created a database, which will then be filled into the database with the rest of the method code. You can use the [SQL Server Object Manager (SSOX) to view the database in Visual Studio.

In SSOX, press [(localdb)\MSSQLLocalDB] & gt; [Databases], and then click on the entry of the database name in the connecting string in the file.

展開 [資料表] 節點以查看資料庫中的資料表。

Expands [datasheets] nodes to view the data sheets in the database.