Templat Pembuatan Kode Desainer

Saat Anda membuat model menggunakan Perancang Kerangka Kerja Entitas, kelas dan konteks turunan Anda secara otomatis dibuat untuk Anda. 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 mana 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.

Nota

Sebaiknya beralih ke templat Generator DbContext setelah Anda menambahkan model Anda.

Halaman ini mencakup templat yang tersedia lalu menyediakan instruksi untuk menambahkan templat ke model Anda.

Templat yang Tersedia

Templat berikut disediakan oleh tim Kerangka Kerja Entitas:

DbContext Generator

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 Anda 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 harus menginstal Alat Kerangka Kerja Entitas terbaru untuk Visual Studio - lihat halaman Dapatkan Kerangka Kerja Entitas untuk informasi selengkapnya.
  • Visual Studio 2010: Templat EF 6.x DbContextGenerator tidak tersedia untuk Visual Studio 2010.

Generator DbContext untuk EF 5.x

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

Jika Anda menggunakan Visual Studio 2013 atau 2012, templat ini sudah diinstal.

Jika Anda 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 pada galeri hanya dapat diinstal di Visual Studio 2010.

Generator DbContext untuk EF 4.x

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

EntityObject Generator

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

Nota

Pertimbangkan untuk menggunakan Generator DbContext

Generator DbContext sekarang 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 Anda 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 Anda 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 diinstal. Jika Anda membuat model baru di Visual Studio 2010, templat ini digunakan secara default tetapi file .tt tidak disertakan dalam proyek Anda. Jika Anda ingin mengkustomisasi templat, Anda harus menambahkannya ke proyek Anda.

Generator Entitas Self-Tracking (STE)

Templat ini akan menghasilkan kelas Entitas Self-Tracking dan konteks yang berasal dari ObjectContext. Dalam aplikasi EF, konteks bertanggung jawab untuk melacak perubahan dalam entitas. Namun, dalam skenario N-Tingkat, konteks mungkin tidak tersedia pada tingkat yang memodifikasi entitas. Entitas pelacakan mandiri membantu Anda melacak perubahan di tingkat apa pun. Untuk informasi selengkapnya, lihat Self-Tracking Entitas.

Nota

Templat STE Tidak Disarankan

Kami tidak lagi merekomendasikan penggunaan templat STE di aplikasi baru, templat tersebut terus tersedia untuk mendukung aplikasi yang ada. Kunjungi artikel entitas yang tidak terhubung untuk opsi lain yang kami rekomendasikan untuk skenario N-Tier.

Nota

Tidak ada versi EF 6.x dari templat STE.

Nota

Tidak ada versi Visual Studio 2013 dari templat STE.

Visual Studio 2012

Jika Anda 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 pada galeri hanya dapat diinstal di Visual Studio 2012.

Visual Studio 2010**

Jika Anda menggunakan Visual Studio 2010, templat ini sudah diinstal.

Generator Entitas POCO

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

Nota

Pertimbangkan untuk menggunakan Generator DbContext

Generator DbContext sekarang 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.

Nota

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

Nota

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, 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 tempat kosong pada permukaan desain di Desainer EF dan pilih Tambahkan Item Pembuatan Kode....

Tambahkan Item Gen Kode

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

Templat Terinstal

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

Templat Pencarian  

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

Nota

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

Templat VS2012

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

Templat VS2010