Freigeben über


Excel-Vorlagenprojektvorlage

Aktualisiert: November 2007

Betrifft

Die Informationen in diesem Thema gelten nur für die angegebenen Projekte und Versionen von Visual Studio Tools for Office von Microsoft Office.

Projekttyp

  • Projekte auf Dokumentebene

Microsoft Office-Version

  • Excel 2007

  • Excel 2003

Weitere Informationen hierzu finden Sie unter Verfügbare Features nach Anwendung und Projekttyp.

Die Excel-Vorlagenprojektvorlage in Visual Basic und Visual C# bildet die Grundlage für Projektmappen, die auf neuen oder vorhandenen Microsoft Office Excel-Vorlagen basieren. Es gibt verschiedene Projektvorlagen für Excel 2003-Vorlagen und Excel 2007-Vorlagen. Die Projektvorlagen fügen automatisch die erforderlichen Assemblyverweise, Dateien und generierten Code hinzu, die als Ausgangspunkt für die Projektmappe verwendet werden.

Wenn eine Vorlage geöffnet wird, um sie nach dem Kompilieren der Projektmappe außerhalb von Visual Studio zu bearbeiten, wird der Code von der Vorlage so ausgeführt, als hätten Sie eine neues Dokument aus der Vorlage erstellt. Je nach Code wird die Vorlage dadurch möglicherweise vor dem Bearbeiten während des Öffnens geändert. Halten Sie beim Öffnen der Vorlage die UMSCHALTTASTE gedrückt, um zu verhindern, dass Code ausgeführt wird.

Hinweis:

Einige der Dateien und Verweise in der folgenden Liste sind standardmäßig ausgeblendet. Um sie einzublenden, klicken Sie auf der Symbolleiste des Projektmappen-Explorers auf Alle Dateien anzeigen. Darüber hinaus gibt es einige Dateien und Verweise, die in vielen Visual Studio-Projektvorlagen gebräuchlich, aber nicht in der folgenden Liste enthalten sind.

Dateien

Visual Studio Tools for Office generiert die folgenden sichtbaren Dateien in Excel 2003- und Excel 2007-Vorlagenprojekten:

  • Arbeitsmappenname.xls – Stellt die Excel-Arbeitsmappe im Projekt dar. Enthält alle Arbeitsblätter und Diagramme.

  • Sheet1 (VB-Datei bei Visual Basic, CS-Datei bei Visual C#) – Ein Arbeitsblatt, das die Entwurfsoberfläche und den Code für das erste Arbeitsblatt in der Arbeitsmappe angibt. Weitere Informationen hierzu finden Sie unter Arbeitsblatthostelement.

  • Sheet2 (VB-Datei bei Visual Basic, CS-Datei bei Visual C#) – Ein Arbeitsblatt, das die Entwurfsoberfläche und den Code für das zweite Arbeitsblatt in der Arbeitsmappe angibt.

  • Sheet3 (VB-Datei bei Visual Basic, CS-Datei bei Visual C#) – Ein Arbeitsblatt, das die Entwurfsoberfläche und den Code für das dritte Arbeitsblatt in der Arbeitsmappe angibt.

  • ThisWorkbook (VB-Datei bei Visual Basic, CS-Datei bei Visual C#) – Enthält die Entwurfsoberfläche und den Code für Anpassungen auf Arbeitsmappenebene. Weitere Informationen hierzu finden Sie unter Arbeitsmappenhostelement.

Hinweis:

Sie können in der einem Dokument, einer Arbeitsmappe oder einem Arbeitsblatt zugrunde liegenden Codedatei keine zusätzlichen Klassen hinzufügen. Sie müssen einem Projekt neue Dateien hinzufügen, damit es die zu schreibenden Klassen enthält.

Visual Studio Tools for Office generiert auch die folgende weitere Datei, wenn Sie ein Excel 2007-Vorlagenprojekt erstellen:

Ausgeblendete Dateien

Visual Studio Tools for Office generiert mehrere ausgeblendete Dateien. Die Dateien dürfen nicht manuell geändert werden. Sie werden erneut generiert, wenn Änderungen am Projekt vorgenommen werden. Manuelle Änderungen werden nicht beibehalten.

Visual Studio Tools for Office generiert die folgenden ausgeblendeten Dateien:

  • ThisWorkbook.Designer.xmll - Eine schreibgeschützte deklarative Darstellung der programmierbaren Objekte in der Arbeitsmappe.

  • ThisWorkbook.Designer (VB-Datei oder CS-Datei) - Eine schreibgeschützte Codedatei mit Hilfsimplementierungen für Objekte in der Arbeitsmappe, einschließlich Code zum korrekten Instanziieren von Objekten.

  • .Sheetn.Designer.xml - Eine schreibgeschützte deklarative Darstellung der programmierbaren Objekte in der Arbeitsmappe.

  • Sheetn.Designer (VB-Datei oder CS-Datei) - Eine schreibgeschützte Codedatei mit Hilfsimplementierungen für Objekte im Arbeitsblatt, einschließlich Code zum korrekten Instanziieren von Objekten.

  • Workbook Name.Designer.xml - Eine schreibgeschützte deklarative Darstellung programmierbarer Objekte, z. B. benutzerdefinierter Steuerelemente, die standardmäßig nicht Teil von Visual Studio Tools for Office sind. Diese Datei wird generiert, wenn Sie einem Arbeitsblatt in der Arbeitsmappe ein Benutzersteuerelement hinzufügen.

  • Workbook Name>.Designer (VB-Datei oder CS-Datei) - Eine schreibgeschützte Codedatei mit Hilfsimplementierungen für Benutzersteuerelemente. Diese Datei wird generiert, wenn Sie einem Arbeitsblatt in der Arbeitsmappe ein Benutzersteuerelement hinzufügen.

Vorlagencode

Die folgenden Ereignishandler sind in den Codedateien für Projektvorlagen enthalten. Weitere Informationen finden Sie unter Visual Studio Tools for Office-Projektereignisse.

Startereignishandler

Diese Ereignishandler behandeln das Workbook.Startup-Ereignis und das Worksheet.Startup-Ereignis. Diese Ereignisse werden für jedes Arbeitsblatt und jede Arbeitsmappe ausgelöst, nachdem die Projektmappe gestartet und der gesamte Initialisierungscode in der Assembly ausgeführt wurde. Verwenden Sie diese Ereignishandler, um Code auszuführen, in dem die Projektmappe initialisiert wird.

Die Startup-Ereignishandler in einer Vorlagenprojektmappe werden in dieser Reihenfolge aufgerufen:

  1. ThisWorkbook_Startup.

  2. Sheet1_Startup.

  3. Sheet2_Startup.

  4. Sheet3_Startup.

  5. Andere Blätter in der Reihenfolge.

Die Reihenfolge wird beim Kompilieren des Projekts bestimmt. Wenn die Blätter zur Laufzeit neu angeordnet werden, wird dadurch beim nächsten Öffnen der Arbeitsmappe nicht die Reihenfolge geändert, in der die Ereignisse ausgelöst werden.

Herunterfahren-Ereignishandler

Diese Ereignishandler behandeln das Workbook.Shutdown-Ereignis und das Worksheet.Shutdown-Ereignis. Diese Ereignishandler werden für jedes Arbeitsblatt und für die Arbeitsmappe ausgelöst, wenn die Anwendungsdomäne, in die der Code geladen wird, entladen werden soll.

Die Shutdown-Ereignishandler in einer Vorlagenprojektmappe werden in dieser Reihenfolge aufgerufen:

  1. ThisWorkbook_Shutdown.

  2. Sheet1_Shutdown.

  3. Sheet2_Shutdown.

  4. Sheet3_Shutdown.

  5. Andere Blätter in der Reihenfolge.

Verweise

Visual Studio Tools for Office erstellt automatisch einen Satz von Assemblyverweisen in Excel-Vorlagenprojekten. Diese Verweise schließen die folgenden Assemblys ein:

Siehe auch

Aufgaben

Gewusst wie: Erstellen von Visual Studio Tools for Office-Projekte

Konzepte

Einschränkungen von globalen Vorlagen und Excel-Add-Ins (XLA-Dateien)

Übersicht über Assemblys in Office-Projektmappen

Übersicht über das Excel-Objektmodell

Weitere Ressourcen

Verwalten von Projektmappen, Projekten und Dateien

Office-Projektvorlagen