Bagikan melalui


Templat Pembuatan Kode Perancang

Saat Anda membuat model menggunakan Perancang Entity Framework, kelas dan konteks turunan Anda akan otomatis dibuat. Selain pembuatan kode default, kami juga menyediakan sejumlah templat yang dapat digunakan untuk menyesuaikan kode yang dihasilkan. Templat ini disediakan sebagai Templat Teks T4, memungkinkan Anda menyesuaikan templat jika diperlukan.

Kode yang dihasilkan secara default bergantung pada versi Visual Studio yang Anda buat modelnya:

  • Model yang dibuat di Visual Studio 2012 & 2013 akan menghasilkan kelas entitas POCO sederhana dan konteks yang berasal dari DbContext yang disederhanakan.
  • Model yang dibuat di Visual Studio 2010 akan menghasilkan kelas entitas yang berasal dari EntityObject dan konteks yang berasal dari ObjectContext.

Catatan

Sebaiknya beralih ke templat Generator DbContext setelah Anda menambahkan model.

Halaman ini mencakup templat yang tersedia dan kemudian memberikan instruksi untuk menambahkan templat ke model Anda.

Templat yang Tersedia

Templat berikut disediakan oleh tim Entity Framework:

Generator DbContext

Templat ini akan menghasilkan kelas entitas POCO sederhana dan konteks yang berasal dari DbContext menggunakan EF6. Ini adalah templat yang direkomendasikan kecuali Anda memiliki alasan untuk menggunakan salah satu templat lain yang tercantum di bawah ini. Ini juga merupakan templat pembuatan kode yang Anda dapatkan secara default jika menggunakan versi terbaru Visual Studio (Visual Studio 2013 dan seterusnya): Saat Anda membuat model baru, templat ini digunakan secara default dan file T4 (.tt) disarangkan di bawah file .edmx Anda.

Versi Visual Studio yang lebih lama

  • Visual Studio 2012: Untuk mendapatkan templat EF 6.x DbContextGenerator, Anda perlu menginstal Entity Framework Tools untuk Visual Studio terbaru - lihat halaman Dapatkan Entity Framework untuk informasi selengkapnya.
  • Visual Studio 2010: Templat EF 6.x DbContextGenerator tidak tersedia untuk Visual Studio 2010.

Generator DbContext untuk EF 5.x

Jika menggunakan paket EntityFramework NuGet versi lama (satu dengan versi utama 5), Anda harus menggunakan templat Generator DbContext EF 5.x.

Jika Anda menggunakan Visual Studio 2013 atau 2012, templat ini sudah terinstal di dalamnya.

Jika menggunakan Visual Studio 2010, Anda harus memilih tab Online saat menambahkan templat untuk mengunduhnya dari Visual Studio Gallery. Atau Anda dapat menginstal templat langsung dari Visual Studio Gallery sebelumnya. Karena templat disertakan dalam versi Visual Studio yang lebih baru, versi di galeri hanya dapat diinstal di Visual Studio 2010.

Generator DbContext untuk EF 4.x

Jika menggunakan versi lama paket EntityFramework NuGet (satu dengan versi utama 4), Anda harus menggunakan templat Generator DbContext EF 4.x. Ini dapat ditemukan di tab Online saat menambahkan templat, atau Anda dapat menginstal templat langsung dari Visual Studio Gallery sebelumnya.

Generator EntityObject

Templat ini akan menghasilkan kelas entitas yang berasal dari EntityObject dan konteks yang berasal dari ObjectContext.

Catatan

Sebaiknya gunakan Generator DbContext

Generator DbContext saat ini menjadi templat yang direkomendasikan untuk aplikasi baru. Generator DbContext memanfaatkan API DbContext yang lebih sederhana. Generator EntityObject terus tersedia untuk mendukung aplikasi yang ada.

Visual Studio 2010, 2012 & 2013

Anda harus memilih tab Online saat menambahkan templat untuk mengunduhnya dari Visual Studio Gallery. Atau Anda dapat menginstal templat langsung dari Visual Studio Gallery sebelumnya.

Generator EntityObject untuk EF 5.x

Jika menggunakan Visual Studio 2012 atau 2013, Anda harus memilih tab Online saat menambahkan templat untuk mengunduhnya dari Visual Studio Gallery. Atau Anda dapat menginstal templat langsung dari Visual Studio Gallery sebelumnya. Karena templat disertakan dalam Visual Studio 2010, versi pada galeri hanya dapat diinstal di Visual Studio 2012 & 2013.

Jika hanya ingin pembuatan kode ObjectContext tanpa perlu mengedit templat, Anda dapat kembali ke pembuatan kode EntityObject.

Jika Anda menggunakan Visual Studio 2010, templat ini sudah terinstal di dalamnya. Jika Anda membuat model baru di Visual Studio 2010, templat ini digunakan secara default tetapi file .tt tidak disertakan dalam proyek. Jika ingin menyesuaikan templat, Anda harus menambahkannya ke proyek.

Generator Entitas Pelacakan Mandiri (STE)

Templat ini akan menghasilkan kelas Entitas Pelacakan Mandiri dan konteks yang berasal dari ObjectContext. Di aplikasi EF, konteks bertanggung jawab melacak perubahan dalam entitas. Namun, dalam skenario Tingkat-N, konteksnya mungkin tidak tersedia di tingkat yang mengubah entitas. Entitas pelacakan mandiri membantu Anda melacak perubahan di tingkat mana pun. Untuk informasi selengkapnya, lihat Entitas Pelacakan Mandiri.

Catatan

Templat STE Tidak Direkomendasikan

Penggunaan templat STE di aplikasi baru tidak lagi direkomendasikan, templat tersebut terus tersedia untuk mendukung aplikasi yang ada. Kunjungi artikel entitas yang terputus untuk opsi lain yang disarankan untuk skenario Tingkat-N.

Catatan

Tidak ada versi EF 6.x dari templat STE.

Catatan

Tidak ada versi Visual Studio 2013 dari templat STE.

Visual Studio 2012

Jika menggunakan Visual Studio 2012, Anda harus memilih tab Online saat menambahkan templat untuk mengunduhnya dari Visual Studio Gallery. Atau Anda dapat menginstal templat langsung dari Visual Studio Gallery sebelumnya. Karena templat disertakan dalam Visual Studio 2010, versi di galeri hanya dapat diinstal di Visual Studio 2012.

Visual Studio 2010**

Jika Anda menggunakan Visual Studio 2010, templat ini sudah terinstal di dalamnya.

Generator Entitas POCO

Templat ini akan menghasilkan kelas entitas POCO dan konteks yang berasal dari ObjectContext

Catatan

Sebaiknya gunakan Generator DbContext

Generator DbContext saat ini menjadi templat yang direkomendasikan untuk menghasilkan kelas POCO di aplikasi baru. Generator DbContext memanfaatkan API DbContext baru dan dapat menghasilkan kelas POCO yang lebih sederhana. Generator Entitas POCO terus tersedia untuk mendukung aplikasi yang ada.

Catatan

Tidak ada versi EF 5.x atau EF 6.x dari templat STE.

Catatan

Tidak ada versi Visual Studio 2013 dari templat POCO.

Visual Studio 2012 & Visual Studio 2010

Anda harus memilih tab Online saat menambahkan templat untuk mengunduhnya dari Visual Studio Gallery. Atau Anda dapat menginstal templat langsung dari Visual Studio Gallery sebelumnya.

Apa itu Templat "Situs Web"

Templat "Situs Web" (misalnya, Generator DbContext EF 5.x untuk Situs Web C#) digunakan dalam proyek Situs Web yang dibuat melalui File -> Baru -> Situs Web.... Ini berbeda dari Aplikasi Web yang dibuat melalui File -> Baru -> Proyek..., yang menggunakan templat standar. Kami menyediakan templat terpisah karena sistem templat item di Visual Studio memerlukannya.

Menggunakan templat

Untuk mulai menggunakan templat pembuatan kode, klik kanan spot kosong pada permukaan desain di Perancang EF dan pilih Tambahkan Item Pembuatan Kode....

Add Code Gen Item

Jika Anda sudah menginstal templat yang ingin digunakan (atau disertakan dalam Visual Studio), maka templat tersebut akan tersedia di bagian Kode atau Data dari menu sebelah kiri.

Installed Template

Jika Anda belum menginstal templat, pilih Online dari menu sebelah kiri dan cari templat yang diinginkan.

Search Template 

Jika Anda menggunakan Visual Studio 2012, file .tt baru akan disarangkan di file .edmx.*

Catatan

Untuk model yang dibuat di Visual Studio 2012, Anda harus menghapus templat yang digunakan untuk pembuatan kode default, jika tidak, Anda akan menghasilkan kelas dan konteks duplikat. File defaultnya adalah <nama model>.tt dan <nama model>.context.tt

VS2012 Templates

Jika Anda menggunakan Visual Studio 2010, file tt ditambahkan langsung ke proyek.  

VS2010 Templates