Designer-Codegenerierungsvorlagen

Wenn Sie ein Modell mithilfe des Entity Framework-Designers erstellen, werden Ihre Klassen und abgeleiteten Kontext automatisch für Sie generiert. Zusätzlich zur Standardcodegenerierung stellen wir auch eine Reihe von Vorlagen bereit, mit denen der generierte Code angepasst werden kann. Diese Vorlagen werden als T4-Textvorlagen bereitgestellt, sodass Sie die Vorlagen bei Bedarf anpassen können.

Der standardmäßig generierte Code hängt von der Version von Visual Studio ab, in der Sie Ihr Modell erstellen:

  • Modelle, die in Visual Studio 2012 & 2013 erstellt wurden, generieren einfache POCO-Entitätsklassen und einen Kontext, der von dem vereinfachten DbContext abgeleitet wird.
  • In Visual Studio 2010 erstellte Modelle generieren Entitätsklassen, die von EntityObject abgeleitet sind, und einen Kontext, der von ObjectContext abgeleitet wird.

Hinweis

Wir empfehlen, zur Vorlage "DbContext-Generator" zu wechseln, nachdem Sie Ihr Modell hinzugefügt haben.

Auf dieser Seite werden die verfügbaren Vorlagen behandelt und dann Anweisungen zum Hinzufügen einer Vorlage zu Ihrem Modell bereitgestellt.

Verfügbare Vorlagen

Die folgenden Vorlagen werden vom Entity Framework-Team bereitgestellt:

DbContext-Generator

Diese Vorlage generiert einfache POCO-Entitätsklassen und einen Kontext, der von DbContext mithilfe von EF6 abgeleitet wird. Dies ist die empfohlene Vorlage, es sei denn, Sie haben einen Grund, eine der anderen unten aufgeführten Vorlagen zu verwenden. Es ist auch die Codegenerierungsvorlage, die Sie standardmäßig erhalten, wenn Sie aktuelle Versionen von Visual Studio (ab Visual Studio 2013) verwenden: Wenn Sie ein neues Modell erstellen, wird diese Vorlage standardmäßig verwendet, und die T4-Dateien (TT) werden unter Ihrer EDMX-Datei geschachtelt.

Ältere Versionen von Visual Studio

  • Visual Studio 2012: Um die EF 6.x DbContextGenerator-Vorlagen abzurufen, müssen Sie die neuesten Entity Framework Tools für Visual Studio installieren . Weitere Informationen finden Sie auf der Seite " Entitätsframework abrufen ".
  • Visual Studio 2010: Die EF 6.x DbContextGenerator-Vorlagen sind für Visual Studio 2010 nicht verfügbar.

DbContext-Generator für EF 5.x

Wenn Sie eine ältere Version des EntityFramework NuGet-Pakets (eine mit einer Hauptversion von 5) verwenden, müssen Sie die EF 5.x DbContext Generator-Vorlage verwenden.

Wenn Sie Visual Studio 2013 oder 2012 verwenden, ist diese Vorlage bereits installiert.

Wenn Sie Visual Studio 2010 verwenden, müssen Sie beim Hinzufügen der Vorlage die Registerkarte "Online " auswählen, um sie aus dem Visual Studio-Katalog herunterzuladen. Alternativ können Sie die Vorlage voraus direkt aus der Visual Studio Gallery installieren. Da die Vorlagen in späteren Versionen von Visual Studio enthalten sind, können die Versionen im Katalog nur in Visual Studio 2010 installiert werden.

DbContext-Generator für EF 4.x

Wenn Sie eine ältere Version des EntityFramework NuGet-Pakets (eine mit einer Hauptversion von 4) verwenden, müssen Sie die EF 4.x DbContext Generator-Vorlage verwenden. Dies finden Sie auf der Registerkarte "Online " beim Hinzufügen der Vorlage, oder Sie können die Vorlage vorab direkt aus dem Visual Studio-Katalog installieren.

EntityObject-Generator

Diese Vorlage generiert Entitätsklassen, die von EntityObject abgeleitet werden, und einen Kontext, der von ObjectContext abgeleitet wird.

Hinweis

Erwägen Sie die Verwendung des DbContext-Generators.

Der DbContext-Generator ist jetzt die empfohlene Vorlage für neue Anwendungen. Der DbContext-Generator nutzt die einfachere DbContext-API. Der EntityObject-Generator ist weiterhin verfügbar, um vorhandene Anwendungen zu unterstützen.

Visual Studio 2010, 2012 & 2013

Sie müssen die Registerkarte "Online " auswählen, wenn Sie die Vorlage hinzufügen, um sie aus dem Visual Studio-Katalog herunterzuladen. Alternativ können Sie die Vorlage vorab direkt aus der Visual Studio-Galerie installieren.

EntityObject-Generator für EF 5.x

Wenn Sie Visual Studio 2012 oder 2013 verwenden, müssen Sie beim Hinzufügen der Vorlage die Registerkarte "Online " auswählen, um sie aus dem Visual Studio-Katalog herunterzuladen. Alternativ können Sie die Vorlage vorab direkt aus der Visual Studio-Galerie installieren. Da die Vorlagen in Visual Studio 2010 enthalten sind, können die Versionen im Katalog nur in Visual Studio 2012 & 2013 installiert werden.

Wenn Sie nur möchten, dass ObjectContext-Code generiert wird, ohne die Vorlage bearbeiten zu müssen, können Sie zur EntityObject-Codegenerierung zurückkehren.

Wenn Sie Visual Studio 2010 verwenden, ist diese Vorlage bereits installiert. Wenn Sie in Visual Studio 2010 ein neues Modell erstellen, wird diese Vorlage standardmäßig verwendet, die TT-Dateien sind jedoch nicht in Ihrem Projekt enthalten. Wenn Sie die Vorlage anpassen möchten, müssen Sie sie ihrem Projekt hinzufügen.

Selbstverfolgende Entitäten (STE)-Generator

Diese Vorlage generiert Self-Tracking Entitätsklassen und einen Kontext, der von ObjectContext abgeleitet wird. In einer EF-Anwendung ist ein Kontext für das Nachverfolgen von Änderungen in den Entitäten verantwortlich. In N-Tier-Szenarien steht der Kontext jedoch möglicherweise nicht auf der Ebene zur Verfügung, die die Entitäten ändert. Self-Tracking-Entitäten helfen Ihnen, Änderungen in jeder Ebene nachzuverfolgen. Weitere Informationen finden Sie unter Self-Tracking Entitäten.

Hinweis

STE-Vorlage wird nicht empfohlen

Wir empfehlen nicht mehr, die STE-Vorlage in neuen Anwendungen zu verwenden, es ist weiterhin verfügbar, um vorhandene Anwendungen zu unterstützen. Besuchen Sie den Artikel "Getrennte Entitäten " für andere Optionen, die wir für N-Tier-Szenarien empfehlen.

Hinweis

Es gibt keine EF 6.x-Version der STE-Vorlage.

Hinweis

Es gibt keine Visual Studio 2013-Version der STE-Vorlage.

Visual Studio 2012

Wenn Sie Visual Studio 2012 verwenden, müssen Sie beim Hinzufügen der Vorlage die Registerkarte "Online " auswählen, um sie aus dem Visual Studio-Katalog herunterzuladen. Alternativ können Sie die Vorlage vorab direkt aus der Visual Studio-Galerie installieren. Da die Vorlagen in Visual Studio 2010 enthalten sind, können die Versionen im Katalog nur in Visual Studio 2012 installiert werden.

Visual Studio 2010**

Wenn Sie Visual Studio 2010 verwenden, ist diese Vorlage bereits installiert.

POCO-Entitätsgenerator

Diese Vorlage generiert POCO-Entitätsklassen und einen Kontext, der von ObjectContext abgeleitet wird.

Hinweis

Erwägen Sie die Verwendung des DbContext-Generators.

Der DbContext-Generator ist jetzt die empfohlene Vorlage zum Generieren von POCO-Klassen in neuen Anwendungen. Der DbContext-Generator nutzt die neue DbContext-API und kann einfachere POCO-Klassen generieren. Der POCO-Entitätsgenerator ist weiterhin verfügbar, um vorhandene Anwendungen zu unterstützen.

Hinweis

Es gibt keine EF 5.x- oder EF 6.x-Version der STE-Vorlage.

Hinweis

Es gibt keine Visual Studio 2013-Version der POCO-Vorlage.

Visual Studio 2012 & Visual Studio 2010

Sie müssen die Registerkarte "Online " auswählen, wenn Sie die Vorlage hinzufügen, um sie aus dem Visual Studio-Katalog herunterzuladen. Alternativ können Sie die Vorlage vorab direkt aus der Visual Studio-Galerie installieren.

Was sind die Vorlagen für "Websites".

Die Vorlagen "Websites" (z. B. EF 5.x DbContext-Generator für C#-Websites) dienen zur Verwendung in Websiteprojekten, die über "File " -> New -> Website... erstellt werden. Dies unterscheidet sich von Webanwendungen, die über Datei -> Neu -> Project... erstellt werden, die die Standardvorlagen verwenden. Wir stellen separate Vorlagen bereit, da das Elementvorlagensystem in Visual Studio sie erfordert.

Verwenden einer Vorlage

Um mit der Verwendung einer Codegenerierungsvorlage zu beginnen, klicken Sie mit der rechten Maustaste auf eine leere Stelle auf der Entwurfsoberfläche im EF-Designer, und wählen Sie "Codegenerierungselement hinzufügen" aus.

Hinzufügen eines Code gen-Elements

Wenn Sie die Vorlage bereits installiert haben, die Sie verwenden möchten (oder in Visual Studio enthalten war), steht sie entweder im Abschnitt "Code " oder " Daten " im linken Menü zur Verfügung.

Installierte Vorlage

Wenn Sie die Vorlage noch nicht installiert haben, wählen Sie im linken Menü "Online " aus, und suchen Sie nach der gewünschten Vorlage.

Suchvorlage  

Wenn Sie Visual Studio 2012 verwenden, werden die neuen TT-Dateien unter der EDMX-Datei geschachtelt.*

Hinweis

Für modelle, die in Visual Studio 2012 erstellt wurden, müssen Sie die Vorlagen löschen, die für die Standardcodegenerierung verwendet werden, andernfalls werden doppelte Klassen und Kontext generiert. Die Standarddateien sind <"model name.tt>" und <"model name.context.tt>". 

VS2012-Vorlagen

Wenn Sie Visual Studio 2010 verwenden, werden die TT-Dateien direkt zu Ihrem Projekt hinzugefügt.  

VS2010-Vorlagen

  • Last updated on