Aracılığıyla paylaş

Designer Kodu Oluşturma Şablonları

  • Makale

Entity Framework Designer’ı kullanarak bir model oluşturduğunuzda sınıflarınız ve türetilmiş bağlam sizin için otomatik olarak oluşturulur. Varsayılan kod oluşturma sürecine ek olarak, oluşturulan kodu özelleştirmek için kullanılabilecek bir dizi şablon da sağlıyoruz. Bu şablonlar T4 Metin Şablonları olarak sağlanır ve gerekirse şablonları özelleştirmenize olanak sağlar.

Varsayılan olarak oluşturulan kod, modelinizi oluşturduğunuz Visual Studio sürümüne göre değişir:

  • Visual Studio 2012 ve 2013'te oluşturulan modeller basit POCO varlık sınıfları ve basitleştirilmiş DbContext'ten türetilen bir bağlam oluşturur.
  • Visual Studio 2010’da oluşturulan modeller, EntityObject kaynağından türetilen varlık sınıfları ve ObjectContext kaynağından türetilen bir bağlam oluşturur.

Dekont

Modelinizi ekledikten sonra DbContext Generator şablonuna geçmeniz önerilir.

Bu sayfa kullanılabilir şablonları kapsar ve ardından modelinize şablon eklemeye yönelik yönergeler sunar.

Kullanılabilir Şablonlar

Aşağıdaki şablonlar Entity Framework ekibi tarafından sağlanmıştır:

DbContext Generator

Bu şablon basit POCO varlık sınıfları ve EF6 kullanarak DbContext kaynağından türetilen bir bağlam oluşturur. Aşağıda listelenen diğer şablonlardan birini kullanmak için bir nedeniniz yoksa bu şablonu kullanmanız önerilir. Ayrıca Visual Studio’nun son sürümlerini (Visual Studio 2013 ve üzeri) kullanıyorsanız varsayılan olarak sunulan kod oluşturma şablonu da budur. Yeni bir model oluşturduğunuzda varsayılan olarak bu şablon kullanılır ve T4 dosyaları (.tt) .edmx dosyanızın altına yerleştirilir.

Visual Studio’nun daha eski sürümleri

  • Visual Studio 2012: EF 6.x DbContextGenerator şablonlarını elde etmek isterseniz Visual Studio için Entity Framework Araçları’nın son sürümünü yüklemeniz gerekir. Daha fazla bilgi için bkz. Entity Framework’ü Alma.
  • Visual Studio 2010: EF 6.x DbContextGenerator şablonları Visual Studio 2010 ile kullanılamaz.

EF 5.x için DbContext Generator

EntityFramework NuGet paketinin eski bir sürümünü (ana sürümü 5 olan) kullanıyorsanız EF 5.x DbContext Generator şablonunu kullanmanız gerekir.

Visual Studio 2013 veya 2012 kullanıyorsanız bu şablon yüklüdür.

Visual Studio 2010 kullanıyorsanız, şablonu Visual Studio Galerisi’nden indirmek üzere eklerken Çevrimiçi sekmesini seçmeniz gerekir. Alternatif olarak şablonu önceden doğrudan Visual Studio Galerisi’nden yükleyebilirsiniz. Şablonlar Visual Studio’nun sonraki sürümlerinde yer aldığı için galerideki sürümler yalnızca Visual Studio 2010’a yüklenebilir.

EF 4.x için DbContext Generator

EntityFramework NuGet paketinin eski bir sürümünü (ana sürümü 4 olan) kullanıyorsanız EF 4.x DbContext Generator şablonunu kullanmanız gerekir. Bu, şablonu eklerken Çevrimiçi sekmesinde bulunabilir veya şablonu önceden doğrudan Visual Studio Galerisi’nden yükleyebilirsiniz.

EntityObject Generator

Bu şablon, EntityObject kaynağından türetilen varlık sınıfları ve ObjectContext kaynağından türetilen bir bağlam oluşturur.

Dekont

DbContext Generator’ı kullanmayı değerlendirin

DbContext Generator, yeni uygulamalar için önerilen şablondur. DbContext Generator, daha basit olan DbContext API’sinin avantajlarından yararlanır. EntityObject Generator mevcut uygulamaları desteklemek için kullanılabilir.

Visual Studio 2010, 2012 ve 2013

Şablonu Visual Studio Galerisi’nden indirmek üzere eklerken Çevrimiçi sekmesini seçmeniz gerekir. Alternatif olarak şablonu önceden doğrudan Visual Studio Galerisi’nden yükleyebilirsiniz.

EF 5.x için EntityObject Generator

Visual Studio 2012 veya 2013 kullanıyorsanız, şablonu Visual Studio Galerisi’nden indirmek üzere eklerken Çevrimiçi sekmesini seçmeniz gerekir. Alternatif olarak şablonu önceden doğrudan Visual Studio Galerisi’nden yükleyebilirsiniz. Şablonlar Visual Studio 2010'a eklendiğinden galerideki sürümler yalnızca Visual Studio 2012 ve 2013'e yüklenebilir.

Şablonu düzenlemeye gerek kalmadan yalnızca ObjectContext kodu oluşturmak istiyorsanız EntityObject kod oluşturma işlemini geri alabilirsiniz.

Visual Studio 2010 kullanıyorsanız bu şablon yüklüdür. Visual Studio 2010’da yeni bir model oluşturursanız bu şablon varsayılan olarak kullanılır ancak .tt dosyaları projenize dahil edilmez. Şablonu özelleştirmek isterseniz ilgili dosyayı projenize eklemeniz gerekir.

Self-Tracking Entities (STE) Generator

Bu şablon, Kendini İzleyen Varlık sınıfları ve ObjectContext kaynağından türetilen bir bağlam oluşturur. EF uygulamasında bağlam, varlıklardaki değişiklikleri izlemekten sorumludur. Ancak N Katmanı senaryolarında bağlam, varlıkları değiştiren katmanda kullanılamayabilir. Kendini izleyen varlıklar, herhangi bir katmandaki değişiklikleri izlemenize yardımcı olur. Daha fazla bilgi için bkz. Kendini İzleyen Varlıklar.

Dekont

STE Şablonu Önerilmez

STE şablonunun yeni uygulamalarda kullanılmasını önermiyoruz ancak mevcut uygulamaları destekleme amacıyla kullanılabilir. N Katmanı senaryolarında önerdiğimiz diğer seçenekler için bağlantısı kesilmiş varlıklar makalesini inceleyin.

Dekont

STE şablonunun EF 6.x sürümü yoktur.

Dekont

STE şablonunun Visual Studio 2013 sürümü yoktur.

Visual Studio 2012

Visual Studio 2012 kullanıyorsanız, şablonu Visual Studio Galerisi’nden indirmek üzere eklerken Çevrimiçi sekmesini seçmeniz gerekir. Alternatif olarak şablonu önceden doğrudan Visual Studio Galerisi’nden yükleyebilirsiniz. Şablonlar Visual Studio 2012 sürümlerinde yer aldığı için galerideki sürümler yalnızca Visual Studio 2010’a yüklenebilir.

Visual Studio 2010**

Visual Studio 2010 kullanıyorsanız bu şablon yüklüdür.

POCO Entity Generator

Bu şablon, POCO varlık sınıfları ve ObjectContext kaynağından türetilen bir bağlam oluşturur

Dekont

DbContext Generator’ı kullanmayı değerlendirin

DbContext Generator artık yeni uygulamalarda POCO sınıfları oluşturmak için önerilen şablondur. DbContext Generator, yeni DbContext API’sinin avantajlarından yararlanır ve daha basit POCO sınıfları oluşturabilir. POCO Entity Generator mevcut uygulamaları desteklemek için kullanılabilir.

Dekont

STE şablonunun EF 5.x veya EF 6.x sürümü yoktur.

Dekont

POCO şablonunun Visual Studio 2013 sürümü yoktur.

Visual Studio 2012 ve Visual Studio 2010

Şablonu Visual Studio Galerisi’nden indirmek üzere eklerken Çevrimiçi sekmesini seçmeniz gerekir. Alternatif olarak şablonu önceden doğrudan Visual Studio Galerisi’nden yükleyebilirsiniz.

“Web Siteleri” Şablonları ne işe yarar?

“Web Siteleri” şablonları (örneğin, C# Web Siteleri için EF 5.x DbContext Generator), Dosya -> Yeni -> Web Sitesi... komutuyla oluşturulan Web Sitesi projelerinde kullanılır. Bunlar, Dosya -> Yeni -> Proje... komutuyla oluşturulan ve standart şablonları kullanan Web Uygulamalarından farklıdır. Visual Studio’daki öğe şablonu sistemi için gerekli olduğundan ayrı şablonlar sağlıyoruz.

Şablon Kullanma

Kod oluşturma şablonu kullanmaya başlamak için EF Designer’da tasarım yüzeyinde boş bir noktaya sağ tıklayın ve Kod Oluşturma Öğesi Ekle... girişini seçin.

Add Code Gen Item

Kullanmak istediğiniz şablonu önceden yüklediyseniz (veya Visual Studio’da mevcutsa) soldaki menünün Kod veya Veri bölümünde görüntülenir.

Installed Template

Şablonu henüz yüklemediyseniz soldaki menüden Çevrimiçi girişini seçin ve istediğiniz şablonu arayın.

Search Template 

Visual Studio 2012 kullanıyorsanız yeni .tt dosyaları, .edmx dosyasının altına yerleştirilecektir.*

Dekont

Visual Studio 2012’de oluşturulan modellerde varsayılan kod oluşturma işlemi için kullanılan şablonları silmeniz gerekir. Aksi takdirde yinelenen sınıflar ve bağlam oluşturulur. Varsayılan dosyalar <model adı>.tt ve <model adı>.context.tt şeklindedir. 

VS2012 Templates

Visual Studio 2010 kullanıyorsanız .tt dosyaları doğrudan projenize eklenir.  

VS2010 Templates