Bereitstellen einer Office-Lösung mithilfe von Windows Installer

  • Artikel

Erfahren Sie, wie Sie eine Windows Installer-Datei (MSI-Datei) für die Office 2013 oder Office 2010-Projektmappe erstellt, indem Sie Visual Studio 2012 verwenden.

Mit Visual Studio 2012 verwenden, um eine Windows Installer-Datei erstellen, können Sie eine Office 2013 oder Office 2010-Projektmappe bereitstellen, die Administratoren Zugriff auf dem Computer des Endbenutzers erfordert.Beispielsweise können Sie eine solche Datei verwenden, um Benutzer einer Projektmappe nur eines Computers einmal für alle zu installieren.Sie können auch eine Office-Projektmappe bereitstellen, indem Sie ClickOnce, aber diese Projektmappe muss für jeden Benutzer des Computers getrennt installiert werden.

Um eine vollständige Liste von Unterschieden zwischen Windows Installer-Bereitstellung und ClickOnce-Bereitstellung anzuzeigen, finden Sie unter Auswählen einer Bereitstellungsstrategie.

In diesem Thema

  • Laden Sie Beispiele herunter

  • Rufen Sie InstallShield eingeschränkte Edition ab

  • Entscheiden Sie, wie der Projektmappe Vertrauenswürdigkeit gewährt

  • Erstellen Sie ein Setup-Projekt

  • Fügen Sie die Projektausgabe hinzu

  • Fügen Sie die Bereitstellung und die Anwendungsmanifeste hinzu

  • Konfigurieren Sie die abhängigen Komponenten als erforderliche Komponenten

  • Geben Sie an, wo die Projektmappe auf dem Computer des Benutzers installiert

  • Configure an add-in

  • Konfigurieren Sie eine Anpassung auf Dokumentebene

  • Erstellen Sie das Setupprojekt auf

Weitere Informationen darüber, wie Sie eine Office-Projektmappe, mithilfe von ClickOnce, finden Sie unter Bereitstellen einer Office-Lösung mithilfe von ClickOnce bereitstellt.

Informationen darüber, wie Sie eine Windows Installer-Datei, indem Sie Visual Studio 2010 verwenden, finden Bereitstellen Visual Studio 2010 Tools für Office-Projektmappe mit Windows Installer Sie unter.

Laden Sie Beispiele herunter

In diesem Thema werden die folgenden herunterladbaren Beispiele.

Beispiel

Beschreibung

ExcelAddIn

Ein übertreffungs-Add-In, das Sie auf einem Computer installieren können, der eine 32-Bit- oder 64-Bit-Version von Office ausführt.

ExcelWorkbook

Eine Anpassung auf Dokumentebene Excel, die Sie auf einem Computer installieren können, der eine 32-Bit- oder 64-Bit-Version von Office ausführt.

Entscheiden Sie, wie der Projektmappe Vertrauenswürdigkeit gewährt

Bevor eine Projektmappe auf Benutzercomputer ausgeführt werden kann, müssen Sie Vertrauenswürdigkeit in entweder der folgenden Methoden gewähren, oder Benutzer müssen auf eine Nachfrage, wenn sie die Projektmappe installieren.

HinweisHinweis

Bei Anpassungen auf Dokumentebene muss der Speicherort des Dokuments auch vertraut machen.Weitere Informationen finden Sie unter Gewähren von Vertrauenswürdigkeit für Dokumente.

Rufen Sie InstallShield eingeschränkte Edition ab

Sie können eine Windows Installer-Datei erstellen, indem Sie InstallShield Limited- Edition (ISLE) verwenden, die frei ist, wenn Sie Visual Studio installiert haben.ISLE ersetzt die Funktionen der Projektvorlagen für Setup und Bereitstellung, die frühere Versionen von Visual Studio anboten.

So InstallShield Limited- Edition abrufen

  1. Wählen Sie in der Menüleiste Datei, Neu, Projekt aus.

    Das Dialogfeld Neues Projekt wird angezeigt.

  2. Erweitern Sie im Vorlagenbereich den Andere Projekttypen und dann die Vorlage aus. Setup und Bereitstellung

  3. In der Liste der - Projekttypen für Setup und Bereitstellung, wählen Sie InstallShield Limited Edition aktivieren aus und wählen dann die Schaltfläche OK aus.

    Eine Seite wird, stellt die Informationen darüber, wie InstallShield Limited- Edition abruft.

  4. Auf dieser Seite den Rufen Sie die Downloadwebsite auf Link aus.

  5. Klicken Sie auf der Downloadseite für InstallShield Limited- Edition, geben Sie die erforderlichen Informationen in die entsprechenden Felder ein, und wählen Sie dann den Jetzt herunterladen Link aus.

    Nachdem Sie das Produkt herunterladen, installieren und aktivieren, wird die InstallShield Limited Edition-Projekt Vorlage in Visual Studio.

Erstellen Sie ein Setup-Projekt

  1. In Visual Studio öffnen Sie das Office-Projekt, das Sie bereitstellen möchten.

    Die Beispiele für Add-Ins auf Anwendungsebene, die diesem Thema zugeordnet werden, enthalten ein Projekt, das ExcelAddIn genannt wird.Die Anpassungsbeispiele auf Dokumentebene enthalten ein Projekt, das ExcelWorkbook genannt wird.Dieses Thema behandelt das Office-Projekt in der Projektmappe an, indem es einen dieser zwei Namen verwendet.

  2. Wählen Sie auf der Menüleiste Datei, Hinzufügen, Neues Projekt aus.

    Das Dialogfeld wird geöffnet. Neues Projekt hinzufügen

  3. Erweitern Sie im Vorlagenbereich den Andere Projekttypen und dann die Vorlage aus. Setup und Bereitstellung

  4. In der Liste der - Projekttypen für Setup und Bereitstellung, wählen Sie InstallShield Limited Edition-Projekt aus, nennen Sie das Projekt, und wählen Sie dann die Schaltfläche OK aus.

    Das InstallShieldsetupprojekt, das Sie gerade erstellt haben, wird in der Projektmappe.

    Die Beispiele für dieses Thema enthalten ein Setup-Projekt, das OfficeAddInSetup genannt wird.Dieses Thema bezieht sich auf das Setup-Projekt in der Projektmappe an, indem es den gleichen Namen verwendet.

Fügen Sie die Projektausgabe hinzu

Sie konfigurieren das OfficeAddInSetup Projekt, die Ausgabe des Office-Projekts einzuschließen.Für Add-In-Projekt auf Anwendungsebene ist die Projektausgabe nur die Projektmappenassembly.Für Anpassungsprojekte auf Dokumentebene umfasst die Projektausgabe nicht nur die Projektmappenassembly jedoch auch das Dokument selbst.

Um die Projektausgabe hinzu

  1. In Projektmappen-Explorer erweitern Sie den OfficeAddInSetup Projektknoten, und wählen Sie dann die Datei Projekt-Assistent aus, die in der folgenden Abbildung dargestellt.

    Projekt-Assistentdatei im Projektmappen-Explorer

  2. Klicken Sie auf der Menüleiste wählen Sie Ansicht, Öffnen aus.

  3. Am unteren Rand der Seite Projekt-Assistent die Schaltfläche Anwendungsdateien aus, die in der folgenden Abbildung dargestellt.

    Die Schaltfläche "Anwendungsdateien".

  4. Auf der Seite Anwendungsdateien die Schaltfläche Projektausgaben hinzufügen aus.

  5. Im Dialogfeld Visual Studio-AusgabeselektorPrimäre Ausgabe aktivieren Sie das Kontrollkästchen, und wählen Sie dann die Schaltfläche OK aus.

Fügen Sie die Bereitstellung und die Anwendungsmanifeste hinzu

  1. Auf der Seite Anwendungsdateien die Schaltfläche Dateien hinzufügen aus.

  2. Im Dialogfeld Öffnen navigieren Sie zum Ausgabeverzeichnis des Projekts ExcelAddIn.

    Normalerweise ist das Ausgabeverzeichnis der Unterordner bin\release des Projektstammverzeichnisses, abhängig von der Buildkonfiguration, die Sie auswählen.

  3. Im Ausgabeverzeichnis wählen Sie die ExcelAddIn.vsto und ExcelAddIn.dll.manifest Dateien aus, und wählen Sie dann die Schaltfläche Öffnen aus.

    Die Seite Anwendungsdateien enthält jetzt die Projektausgabedatei, das Bereitstellungsmanifest und das Anwendungsmanifest, wie in der folgenden Abbildung gezeigt.

    Die Ausgabedateien des Setupprojekts.

Konfigurieren Sie die abhängigen Komponenten als erforderliche Komponenten

In der vom müssen Sie nicht nur die folgenden Komponenten jedoch auch alle anderen Komponenten einschließen, die erforderlich sind, damit die Lösung ausgeführt wird.

  • Die Version von .NET Framework Ziele dieser die Office-Projektmappe.

  • Die Microsoft Visual Studio 2010-Tools für Office-Laufzeit.

Cc442767.collapse_all(de-de,VS.110).gifFügen Sie .NET Framework 4 oder .NET Framework 4.5 als erforderliche Komponente hinzu

  1. In Projektmappen-Explorer erweitern Sie den OfficeAddInSetup Projektknoten Anwendungsdaten angeben, erweitern Sie den Knoten, und wählen Sie dann die Datei Redistributables aus, die in der folgenden Abbildung dargestellt.

    Verteilbare Datei im Projektmappen-Explorer

  2. Klicken Sie auf der Menüleiste wählen Sie Ansicht, Öffnen aus.

    Die Seite Redistributables wird geöffnet.

  3. In der Liste der verteilbaren Komponenten entsprechend, aktivieren Sie das Kontrollkästchen für die Version von .NET Framework Ziele dieser eine Projektmappe aus.

    Wenn die Projektmappe .NET Framework 4.5 ausgerichtet ist, wählen Sie das Kontrollkästchen Microsoft .NET Framework 4.5 Vollständig.Ein Dialogfeld könnte aus, das Sie dazu auffordert, die weitervertreibbare Komponente installieren möchten, die InstallShield benötigt, bevor Sie die Komponente als erforderliche Komponente hinzufügen können.Wenn dieses Dialogfeld nicht angezeigt wird, ist die Komponente bereits auf dem Computer.

  4. Wenn das Dialogfeld angezeigt wird, wählen Sie die Schaltfläche Ja, um die weitervertreibbare Komponente herunterzuladen.

    HinweisHinweis

    Eine Fehlermeldung kann darauf hinweisen, dass der Download fehlgeschlagen ist.Sie können diesen Fehler normalerweise ignorieren.Um sicherzustellen dass Sie erfolgreich die Datei heruntergeladen haben, wechseln Sie zum folgenden Verzeichnis auf dem Computer:

    Bei 32-Bit-Betriebssystemen: %ProgramFiles%\InstallShield\2012SpringLE\SetupPrerequisites\Microsoft.net\Version\FullOrClient\

    Für 64-Bit-Betriebssysteme: %Programme (x86) %\InstallShield\2012SpringLE\SetupPrerequisites\Microsoft.net\Version\FullOrClient\

    Wenn die Datei nicht in auch nicht von diesen Verzeichnisse ist, müssen Sie sie herunterladen und im entsprechenden Verzeichnis ablegen.

    Wenn Sie .NET Framework 4 herunterladen, finden Sie unter https://download.microsoft.com/download/9/5/A/95A9616B-7A37-4AF6-BC36-D6EA96C8DAAE/dotNetFx40_Full_x86_x64.exe

    Um den .NET Framework 4-Client herunterzuladen, finden Sie unter https://download.microsoft.com/download/5/6/2/562A10F9-C9F4-4313-A044-9C94E0A8FAC8/dotNetFx40_Client_x86_x64.exe

    Wenn Sie .NET Framework 4.5 herunterladen, finden Sie unter https://download.microsoft.com/download/b/a/4/ba4a7e71-2906-4b2d-a0e1-80cf16844f5f/

    HinweisHinweis

    Um die URL jeder erforderlichen Komponente zu suchen Redistributables die auf der Seite aufgeführt ist, öffnen Sie die entsprechende .prq-Datei im Verzeichnis %ProgramFiles%\InstallShield\2012SpringLE\SetupPrerequisites\ auf dem Computer.In jeder .prq-Datei wird die URL URL<file> im - Attribut des - Elements.

Cc442767.collapse_all(de-de,VS.110).gifFügen Sie die Visual Studio 2010 Tools for Office Runtime hinzu

Die Seite Redistributables enthält ein - Element, das Microsoft VSTO 2010 Runtime genannt wird, aber er verweist auf eine frühere Version der Laufzeit.Daher müssen Sie eine Konfigurationsdatei manuell erstellen, die die neueste Version verweist.Sie müssen diese Datei in demselben Verzeichnis wie die Konfigurationsdateien für alle anderen Elemente und die, die auf der Seite Redistributables angezeigt werden.

Um die Visual Studio 2010 Tools for Office Runtime als erforderliche Komponente hinzufügen

  1. Öffnen Sie Editor und fügen Sie dann das folgende XML in eine Textdatei ein.

    <?xml version="1.0" encoding="UTF-8"?>
<SetupPrereq>
<conditions>
    <condition Type="32" Comparison="2" Path="HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VSTO Runtime Setup\v4R" FileName="Version" ReturnValue="10.0.40303" Bits="2"></condition>
</conditions>
<files>
    <file LocalFile="&lt;ISProductFolder&gt;\SetupPrerequisites\VSTOR\vstor_redist.exe" URL="https://go.microsoft.com/fwlink/?LinkId=140384" CheckSum="b6639489e159b854b6dc43d5cb539043" FileSize="0,40023024"></file>
</files>
<execute file="vstor_redist.exe" returncodetoreboot="1641,3010" requiresmsiengine="1">
</execute>
<properties Id="Your GUID goes here" Description="This prerequisite installs the most recent version of the Microsoft Visual Studio 2010 Tools for Office Runtime." >
</properties>

</SetupPrereq>

  2. Generieren Sie ein GUID, indem Sie das GUID-Generator Programm auf dem Computer verwenden.

    Um das GUID-Generator Programm auf Ihrem Computer finden, das Menü Start und den Typ GUIDgenerator öffnen im Suchfeld ein.

  3. Im GUID-Generator Programm aktivieren Sie das Optionsfeld Registrierungsformat, wählen Sie die Schaltfläche Kopieren aus, und wählen Sie dann die Schaltfläche Beenden aus.

  4. Ersetzen Sie im - Editor den Text Your GUID goes here, indem Sie die GUID an ihrer Stelle einfügen.

    Das Element <properties> der Datei ähnelt dem folgenden.

    <properties Id="{87989B73-21DC-4403-8FD1-0C68A41A6D8C}" Description="This prerequisite installs the most recent version of the Microsoft Visual Studio 2010 Tools for Office Runtime." >
</properties>

  5. Geben Sie auf der Menüleiste im Editor, wählen Sie Datei, Speichern aus.

  6. Im Dialogfeld Speichern unter navigieren Sie zu dem Ordner Desktop.

  7. In der Liste wählen Sie DateitypAlle Dateien (*.*) aus.

  8. Im Feld geben Sie DateinameVisual Studio 2010 Tools for Office Runtime.prq ein und klicken Sie dann auf die Schaltfläche Speichern aus.

    HinweisHinweis

    Stellen Sie sicher, dass Sie .prq am Ende des Dateinamens hinzufügen, um diese Datei als erforderliche Datei identifizieren.

  9. Schließen Sie Editor.

  10. Klicken Sie im Ordner Desktop kopieren Sie die Visual Studio 2010 Tools for Office Datei Runtime.prq einem der folgenden Verzeichnisse auf dem Computer.

    Bei 32-Bit-Betriebssystemen: %ProgramFiles%\InstallShield\2012SpringLE\SetupPrerequisites\

    Für 64-Bit-Betriebssysteme: %Programme (x86) %\InstallShield\2012SpringLE\SetupPrerequisites\

  11. Auf der Seite Redistributables einem InstallShield-Projekt, wählen Sie die Schaltfläche Aktualisieren, um die Liste der verteilbaren Komponenten, wie in der folgenden Abbildung zu aktualisieren.

    Die Schaltfläche "Aktualisieren".

  12. In der Liste der verteilbaren Komponenten, aktivieren Sie das Kontrollkästchen. Visual Studio 2010-Tools für Office-Laufzeit

    Ein Dialogfeld könnte aus, das Sie dazu auffordert, die weitervertreibbare Komponente installieren möchten.Wenn dieses Dialogfeld nicht angezeigt wird, können Sie zu Geben Sie an, wo die Projektmappe auf dem Computer des Benutzers installiert den Abschnitt dieses Themas überspringen.

  13. Wenn das Dialogfeld angezeigt wird, wählen Sie die Schaltfläche Ja, um die weitervertreibbare Komponente herunterzuladen.

  14. HinweisHinweis

    Eine Fehlermeldung kann darauf hinweisen, dass der Download fehlgeschlagen ist.Sie können diesen Fehler ignorieren.Um sicherzustellen dass Sie erfolgreich die Datei heruntergeladen haben, wechseln Sie zum folgenden Verzeichnis auf dem Computer:

    Bei 32-Bit-Betriebssystemen: %ProgramFiles%\InstallShield\2012SpringLE\SetupPrerequisites\VSTOR\

    Für 64-Bit-Betriebssysteme: %Programme (x86) %\InstallShield\2012SpringLE\SetupPrerequisites\VSTOR\
    Wichtiger HinweisWichtig

    InstallShield geladen werden eine frühere Version der Laufzeit herunter.Um sicherzustellen, dass Sie die neueste Version haben, laden Sie die aktuelle Version der Visual Studio 2010 Tools for Office Runtime von Microsoft Download Center herunter, und platzieren Sie es im entsprechenden Verzeichnis.

Geben Sie an, wo die Projektmappe auf dem Computer des Benutzers installiert

  1. In Projektmappen-ExplorerOfficeAddInSetup erweitern Sie den Knoten, erweitern Sie den Knoten Setup organisieren, und wählen Sie dann die Datei Allgemeine Informationen aus.

  2. Klicken Sie auf der Menüleiste wählen Sie Ansicht, Öffnen aus.

  3. In der Liste der Eigenschaften, wählen Sie die Schaltfläche Durchsuchen neben der - Eigenschaft INSTALLDIR aus.

  4. Im Dialogfeld INSTALLDIR festlegen wählen Sie einen Ordner auf dem Computer des Benutzers aus, in dem die Projektmappe installieren möchten.

    HinweisHinweis

    Sie können Unterverzeichnisse im Dialogfeld INSTALLDIR festlegen auch erstellen, indem Sie das Kontextmenü für jeden Ordner in der Liste öffnen.

Konfigurieren Sie ein Add-In auf Anwendungsebene

Dieser Abschnitt gilt nur, wenn er ein Add-In auf Anwendungsebene you'redeploying.Wenn Sie eine Anpassung auf Dokumentebene bereitstellen, können Sie zum Konfigurieren Sie eine Anpassung auf Dokumentebene sofort Abschnitt übergehen.

Sie müssen Registrierungsschlüssel erstellen, um die Office-Anwendung zu ermöglichen, das Add-In aufzufinden und zu laden.Der Speicherort des Registrierungsschlüssels hängt von der Office-Anwendung ab.Weitere Informationen finden Sie unter Registrierungseinträge für Add-Ins auf Anwendungsebene.

Um die Registrierung konfigurieren

  1. In Projektmappen-Explorer erweitern Sie den OfficeAddInSetup Projektknoten Setup organisieren, erweitern Sie den Knoten, und wählen Sie dann die Datei Allgemeine Informationen aus.

  2. Klicken Sie auf der Menüleiste wählen Sie Ansicht, Öffnen aus.

    Die Eigenschaften des Setup-Projekts angezeigt werden.

  3. In der Liste für die Eigenschaft AllUSERS, geben Sie an, ob diese Projektmappe für alle Benutzer des Computers oder nur für den Benutzer installiert werden soll, der die Projektmappe installiert.

    Um die Projektmappe für alle Benutzer zu installieren, wählen Sie ALLUSERS=1 (Installation pro Computer).

  4. In Projektmappen-Explorer wählen Sie den Knoten Projekt-Assistent aus.

    Klicken Sie auf der Menüleiste wählen Sie Ansicht, Öffnen aus.

  5. Am unteren Rand der Seite Projekt-Assistent die Schaltfläche Anwendungsregistrierung aus, die in der folgenden Abbildung dargestellt.

    Die Schaltfläche "Anwendungsregistrierung".

    Die Seite Anwendungsregistrierung angezeigt wird.

  6. Die Möchten Sie die Registrierungsdaten konfigurieren, die die Anwendung installiert? wählen Sie das Optionsfeld Ja.

  7. In der Liste wählen Sie Registrierungsansicht des ZielcomputersHKEY_USER_SELECTABLE aus.

    Der Ordner HKEY_USER_SELECTABLE wird in den entsprechenden Registrierungshive installiert auf Grundlage, was Sie für die Eigenschaft ALLUSERS dieser Prozedur zuvor ausgewählt haben.Wenn Sie diese Eigenschaft auf festlegen ALLUSERS=1 (Installation pro Computer), die Projektmappe in den HKEY_LOCAL_MACHINE-Registrierungshiven installiert werden.

  8. Öffnen Sie das Kontextmenü für den Ordner HKEY_USER_SELECTABLE, wählen Sie Neu aus und wählen dann Schlüssel aus.

    Ein Ordner, der Neuer Schlüssel 1 genannt wird, wird unter dem Ordner HKEY_USER_SELECTABLE.

  9. Benennen Sie den neuen Ordner Software.

  10. Öffnen Sie das Kontextmenü für den Ordner Software, wählen Sie Neu aus und wählen dann Schlüssel aus.

    Ein Ordner, der Neuer Schlüssel 1 genannt wird, wird unter dem Ordner Software.

  11. Benennen Sie den neuen Ordner Microsoft, und fahren Sie fort, um Unterordners, bis sie die gesamte Schlüsselhierarchie darstellen.

    Die gesamte Schlüsselhierarchie ist HKEY_USER_SELECTABLE\Software\Microsoft\Office\Excel\Addins\SampleCompany.ExcelAddIn.

    Wenn Sie ein Installationsprogramm für 64-Bit-Versionen von Office erstellen, ist die gesamte Hierarchie HKEY_USER_SELECTABLE\Software\Wow6432Node\Microsoft\Office\Excel\Addins\SampleCompany.ExcelAddIn.

    Die folgende Abbildung zeigt die Hierarchie von Schlüsseln auf, wenn Sie diese Übung abgeschlossen haben.

    Die Schlüsselhierarchie der Registrierung.

    HinweisHinweis

    Als empfohlene Vorgehensweise beginnen Sie den Namen des Add-Ins mit dem Namen Ihres Unternehmens.Diese Konvention erhöht die Wahrscheinlichkeit, dass der Schlüssel eindeutig ist und verringert die Wahrscheinlichkeit des Konflikts mit einem Add-In von einem anderen Anbietern.Add-Ins, die denselben Namen haben, können der jeweils anderen Registrierungstasten beispielsweise überschreiben.Dieser Ansatz kann nicht garantieren, dass der Schlüssel eindeutig ist, jedoch kann potenzielle Namenskonflikte reduzieren.

  12. Öffnen Sie das Kontextmenü für die SampleCompany.ExcelAddIn Schlüssel, wählen Sie Neu aus und wählen dann Zeichenfolgenwert aus.

    Der neue Zeichenfolgenwert wird in Liste Registrierungsdaten des Zielcomputers.Der Name des Zeichenfolgenwerts wird hervorgehoben, damit Sie ihn umbenennen können.

  13. Benennen Sie den Wert der Beschreibung.

  14. Wiederholen Sie diesen Vorgang, um die folgenden Werte zu erstellen.

    Werttyp

    Name

    Zeichenfolgenwert

    FriendlyName

    DWORD Wert

    LoadBehavior

    Zeichenfolgenwert

    Manifest

  15. Öffnen Sie das Kontextmenü für den Beschreibung-Wert, und wählen Sie dann Ändern aus.

    Das Dialogfeld wird angezeigt. Daten bearbeiten

  16. Im Wertdaten Textfeld geben Sie Excel-Demo-Add-In ein, und wählen Sie dann die Schaltfläche OK aus.

    Diese Beschreibung wird angezeigt, wenn der Benutzer die Office-Anwendung geöffnet, das Dialogfeld Optionen und anschließend im Bereich, Add-Ins öffnet, das Add-In auswählt.

  17. Öffnen Sie das Kontextmenü für den FriendlyName-Wert, und wählen Sie dann Ändern aus.

    Das Dialogfeld wird angezeigt. Daten bearbeiten

  18. Im Wertdaten Textfeld geben Sie Excel-Demo-Add-In ein, und wählen Sie dann die Schaltfläche OK aus.

    Diese Zeichenfolge wird im Dialogfeld COM-Add-Ins in der Office-Anwendung.Standardmäßig ist der Wert der Zeichenfolge die Add-In ID

  19. Öffnen Sie das Kontextmenü für den LoadBehavior-Wert, und wählen Sie dann Ändern aus.

    Das Dialogfeld wird angezeigt. Daten bearbeiten

  20. Im Wertdaten Textfeld geben Sie 3 ein und klicken Sie dann auf die Schaltfläche OK aus.

    Der Wert 3 wird das Add-In, wenn die Anwendung startet.Weitere Informationen zu LoadBehavior-Werte, finden Sie unter Registrierungseinträge für Add-Ins auf Anwendungsebene.

  21. Öffnen Sie das Kontextmenü für den Manifest-Wert, und wählen Sie dann Ändern aus.

    Das Dialogfeld wird angezeigt. Daten bearbeiten

  22. Im Wertdaten Textfeld geben Sie file:/// [INSTALLDIR] ExcelAddIn.vsto ein|vstolocal und dann die Schaltfläche OK aus.

    Die Visual Studio 2010 Tools for Office Runtime verwendet diesen Pfad, um das Bereitstellungsmanifest zu suchen.Der [INSTALLDIR] Teil dieses Pfads ist ein Makro, das zu INSTALLDIR die Eigenschaft in der Eigenschaftenseite Allgemeine Informationen des InstallShieldsetupprojekts zuordnet.Diese Eigenschaft gibt den Speicherort auf dem Zielcomputer auf, um das Add-In zu installieren.Das |vstolocal Suffix sichergestellt, dass die Projektmappe von Installationsordner geladen wird, nicht dem ClickOnce-Cache.

    Die folgende Abbildung zeigt, wie die Werte angezeigt, nachdem Sie diese Übung abschließen.

    Registrierungswerte für Add-In-Setupprojekt

Wichtiger HinweisWichtig

Wenn Sie einen benutzerdefinierten Formularbereich in einem Add-In für Outlook erstellen, müssen Sie mehr Registrierungseinträge erstellen, um den Bereich mit Outlook zu registrieren.Weitere Informationen finden Sie unter Registrierungseinträge für Outlook-Formularbereiche.

Konfigurieren Sie eine Anpassung auf Dokumentebene

Dieser Abschnitt gilt nur, wenn Sie eine Anpassung auf Dokumentebene bereitstellen.Wenn Sie ein Add-In auf Anwendungsebene bereitstellen, können Sie zum Erstellen Sie das Setupprojekt auf sofort Abschnitt übergehen.

Anpassungen auf Dokumentebene verwenden keine Registrierungsschlüssel.Stattdessen enthalten benutzerdefinierte Dokumenteigenschaften den Speicherort des Bereitstellungsmanifests.

Um benutzerdefinierte Eigenschaften zu ändern, erstellen Sie ein Programm mit der Anpassung auf Dokumentebene aus dem Dokument entfernt, ändern die entsprechenden Eigenschaften und erneuten Anpassung dann in das Dokument.Sie erstellen dann eine benutzerdefinierte Aktion, die das Programm ausgeführt werden können, und Sie fügen diese Aktion im Setup-Projekt hinzu.

So fügen Sie ein Programm erstellen, das Dokumenteigenschaften ändert

  1. Wählen Sie auf der Menüleiste Datei, Hinzufügen, Neues Projekt aus.

    Das Dialogfeld Neues Projekt hinzufügen wird angezeigt.

  2. Erweitern Sie im Vorlagenbereich unter dem Knoten für die Sprache, die Sie verwenden möchten, wählen Sie den Ordner Fenster aus.

  3. In der Liste der - Projekttypen für Fenster, wählen Sie die Konsolenanwendung Vorlage aus.

  4. Nennen Sie das Projekt SetExcelDocumentProperties, und wählen Sie dann die Schaltfläche OK aus.

  5. In Projektmappen-Explorer wählen Sie die Schaltfläche Alle Dateien anzeigen aus, öffnen Sie das Kontextmenü für den SetExcelDocumentProperties Projektknoten, und wählen Sie dann Verweis hinzufügen aus.

  6. Im Dialogfeld Verweis-ManagerErweiterungen wählen Sie die Registerkarte aus, und wählen Sie dann das Kontrollkästchen neben den folgenden Assemblys aus, und wählen Sie dann die Schaltfläche OK aus.

    • Microsoft.VisualStudio.Tools.Applications.Runtime

    • Microsoft.VisualStudio.Tools.Applications.ServerDocument

  7. In Projektmappen-Explorer wählen Sie die Datei (für Program.cs C#-Anwendungen) oder die Datei Module1.vb aus (für Visual Basic-Anwendungen).

  8. Klicken Sie auf der Menüleiste wählen Sie Ansicht, Öffnen aus.

  9. Ersetzen Sie den Inhalt der gesamten Datei durch den folgenden Code.

    Imports Microsoft.VisualStudio.Tools.Applications.Runtime
Imports Microsoft.VisualStudio.Tools.Applications

Module Module1

    Sub Main()

        Dim assemblyLocation As String = ""
        Dim solutionID As Guid
        Dim deploymentManifestLocation As Uri = Nothing
        Dim documentLocation As String = ""
        Dim nonpublicCachedDataMembers As String() = Nothing

        Dim CommandLineArgs As  _
            System.Collections.ObjectModel.ReadOnlyCollection(Of String) = _
            My.Application.CommandLineArgs

        For i As Integer = 0 To CommandLineArgs.Count - 1

            Console.WriteLine(CommandLineArgs(i))
            Dim oArugment As String() = CommandLineArgs(i).Split("=")

            Select Case oArugment(0)

                Case "/assemblyLocation"
                    assemblyLocation = oArugment(1)

                Case "/deploymentManifestLocation"
                    If Not Uri.TryCreate(oArugment(1), UriKind.Absolute, _
                                         deploymentManifestLocation) Then
                        MsgBox("Error creating URI")
                    End If

                Case "/documentLocation"
                    documentLocation = oArugment(1)

                Case "/solutionID"
                    solutionID = Guid.Parse(oArugment(1))
            End Select
        Next
        Try
            ServerDocument.RemoveCustomization(documentLocation)
            ServerDocument.AddCustomization(documentLocation, assemblyLocation, _
                                            solutionID, deploymentManifestLocation, _
                                            True, nonpublicCachedDataMembers)

            Console.WriteLine("Insallation Location Modified Successfully")

        Catch ex As System.IO.FileNotFoundException
            Console.WriteLine("The specified document does not exist.")
            Console.ReadLine()


        Catch ex As System.IO.IOException
            Console.WriteLine("The specified document is read-only.")
            Console.ReadLine()


        Catch ex As InvalidOperationException

            Console.WriteLine("The customization could not be removed.\n" &
                ex.Message)
            Console.ReadLine()


        Catch ex As DocumentNotCustomizedException
            Console.WriteLine("The document could not be customized.\n" &
                ex.Message)
            Console.ReadLine()

        End Try
    End Sub

End Module

    using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using Microsoft.VisualStudio.Tools.Applications.Runtime;
using Microsoft.VisualStudio.Tools.Applications;

namespace SetExcelDocumentProperties
{
    class Program
    {
        static void Main(string[] args)
        {
            string assemblyLocation = "";
            Guid solutionID = new Guid();
            Uri deploymentManifestLocation = null;
            string documentLocation = "";
            string[] nonpublicCachedDataMembers = null;

            for (int i = 0; i <= args.Count() - 1; i++)
            {
                Console.WriteLine(args[i]);
                string[] oArugment = args[i].Split('=');

                switch (oArugment[0])
                {
                    case "/assemblyLocation":
                        assemblyLocation = oArugment[1];
                        break;
                    case "/deploymentManifestLocation":
                        if (!Uri.TryCreate(oArugment[1], UriKind.Absolute, out deploymentManifestLocation))
                        {
                            Console.WriteLine("Error creating URI");
                        }
                        break;
                    case "/documentLocation":
                        documentLocation = oArugment[1];
                        break;
                    case "/solutionID":
                        solutionID = Guid.Parse(oArugment[1]);
                        break;
                }
            }
            try
            {
                ServerDocument.RemoveCustomization(documentLocation);
                ServerDocument.AddCustomization(documentLocation, assemblyLocation,
                                            solutionID, deploymentManifestLocation,
                                            true, out nonpublicCachedDataMembers);

            }
            catch (System.IO.FileNotFoundException)
            {
                Console.WriteLine("The specified document does not exist.");
            }
            catch (System.IO.IOException)
            {
                Console.WriteLine("The specified document is read-only.");
            }
            catch (InvalidOperationException ex)
            {
                Console.WriteLine("The customization could not be removed.\n" +
                    ex.Message);
            }
            catch (DocumentNotCustomizedException ex)
            {
                Console.WriteLine("The document could not be customized.\n" +
                    ex.Message);
            }
        }
    }
}

  10. Kompilieren Sie das Projekt.

So fügen Sie eine benutzerdefinierte Aktion hinzu, die das Programm ausgeführt wird

  1. In Projektmappen-Explorer erweitern Sie den OfficeAddInSetup Projektknoten, und wählen Sie dann die Datei Projekt-Assistent aus, die in der folgenden Abbildung dargestellt.

    Projekt-Assistentdatei im Projektmappen-Explorer

  2. Klicken Sie auf der Menüleiste wählen Sie Ansicht, Öffnen aus.

  3. Am unteren Rand der Seite Projekt-Assistent die Schaltfläche Anwendungsdateien aus, die in der folgenden Abbildung dargestellt.

    Die Schaltfläche "Anwendungsdateien".

  4. Auf der Seite Anwendungsdateien die Schaltfläche Projektausgaben hinzufügen aus.

    Das Dialogfeld wird angezeigt. Visual Studio-Ausgabeselektor

  5. SetExcelDocumentProperties unter dem Knoten Primäre Ausgabe aktivieren Sie das Kontrollkästchen, und wählen Sie dann die Schaltfläche OK aus.

  6. In Projektmappen-Explorer unter dem Knoten OfficeAddInSetup, erweitern Sie den Knoten Setupanforderungen und Aktionen definieren, und wählen Sie dann den Ordner Benutzerdefinierte Aktionen aus.

  7. Klicken Sie auf der Menüleiste wählen Sie Ansicht, Öffnen aus.

    Eine Liste der Ereignisse werden in einem Bereich zur Seite des Bildschirms.

    HinweisHinweis

    Nur einige Ereignisse, die in dieser Liste angezeigt werden, sind in InstallShield Limited- Edition verfügbar.In diesem Verfahren führen Sie das Programm, indem Sie das - Ereignis Dialogfeld nach erfolgreichem Abschluss des Setups verwenden.

  8. In der Liste der Ereignisse, mit Benutzerdefinierte Aktionen bei der Installation, öffnen Sie das Kontextmenü für das Dialogfeld nach erfolgreichem Abschluss des Setups-Ereignis, und wählen Sie dann Neue EXE aus.

    Eine benutzerdefinierte Aktion, die NewCustomAction1 genannt wird, wird unter dem Dialogfeld nach erfolgreichem Abschluss des Setups-Ereignis.Ein Satz von Eigenschaften für die benutzerdefinierte Aktion wird in einem Bereich neben den Ereignissen.

    Wichtiger HinweisWichtig

    Zwei Dialogfeld nach erfolgreichem Abschluss des Setups-Ereignisse werden in der Liste der Ereignisse.Stellen Sie sicher, dass Sie die Instanz von Dialogfeld nach erfolgreichem Abschluss des Setups-Ereignisses auswählen, das Benutzerdefinierte Aktionen bei der Installation unter dem Knoten angezeigt wird.

  9. In der Liste für die Eigenschaft Quellort, wählen Sie Mit Produkt installiert aus.

  10. Wählen Sie die Schaltfläche Durchsuchen neben der - Eigenschaft Dateiname aus.

  11. Im Dialogfeld Zieldatei suchen navigieren Sie zu SetExcelDocumentProperties.Primary.output die Datei, und wählen Sie dann die Schaltfläche Öffnen aus.

    Der Speicherort dieser Datei hängt vom diesem Ordner von angegeben INSTALLDIR für die - Eigenschaft des Setup-Projekts ab.Wenn Sie diese Eigenschaft festlegen zu einem Ordner, der [PersonalFolder]DemoWorkbookApp genannt wird, die Sie Datei SetExcelDocumentProperties.Primary.output suchen können, indem Sie auf [ProgramFilesFolder]\DemoWorkbookApp durchsuchen.

    In den nächsten Schritten rufen Sie die Projektmappe ID Dokumenttyp und dann diese ID als Parameter an die Konsolenanwendung.Sie werden auch der Speicherort des Dokuments, des Bereitstellungsmanifests und der Dokumentenassemblys.

  12. Öffnen Sie das Kontextmenü für die Anwendung für ExcelWorkbook Projekt, und wählen Sie dann Ordner in Windows Explorer öffnen oder Ordner in Datei-Explorer öffnen abhängig vom Betriebssystem aus.

    Der Ordner, der die Projektmappe enthält, wird geöffnet.

  13. Öffnen Sie die Projektdatei der Projektmappe im Editor.In Visual Basic-Projekten ist der Name der Datei ExcelWorkbook.vbproj.In C#-Projekten ist der Name der Datei ExcelWorkbook.csproj.

  14. In der Projektdatei kopieren Suche für das <SolutionID>-Element, dessen Wert in die Zwischenablage und schließen dann Editor.

    Übergeben Sie diesen Wert in die Konsolen-App als Parameter.

  15. In der Eigenschaftenseite von NewCustomAction1, legen Sie die - Eigenschaft die folgenden Befehlszeile Textzeile fest.

    /assemblyLocation="[INSTALLDIR]ExcelWorkbook.dll" /deploymentManifestLocation="[INSTALLDIR]ExcelWorkbook.vsto" /documentLocation="[INSTALLDIR]ExcelWorkbook.xlsx" /solutionID="Your Solution ID"

  16. Ersetzen Sie Your Solution ID durch die Projektmappe ID, die Sie in die Zwischenablage kopiert haben.

    Wichtiger HinweisWichtig

    Testen Sie das Installationsprogramm, um sicherzustellen, dass die Konsolenanwendung, die diese benutzerdefinierte Aktion ausführt, auf Dokumente im [INSTALLDIR-] Verzeichnis zugreifen kann.Einige Verzeichnisse auf dem Computer des Benutzers könnten Administratoren Zugriff, (beispielsweise das Verzeichnis "Programme").Wenn Sie die Projektmappe auf einem Verzeichnis bereitstellen, das Administratoren Zugriff erforderlich ist, sollten Sie das Dialogfeld Eigenschaften der Bereitstellung öffnen, die Registerkarte Kompatibilität aus und wählen dann das Kontrollkästchen Programm als Administrator ausführen, bevor Sie das Installationsprogramm verteilen.Wenn Sie Benutzern das Setupprogramm mit Administratorberechtigungen nicht ausgeführt werden soll, legen Sie die [INSTALLDIR-] Eigenschaft zu einem Verzeichnis, in dem der Benutzer wahrscheinlich bereits Zugriff hat, wie dem Dokumente Verzeichnis fest.Weitere Informationen finden Sie in diesem Thema im Abschnitt Geben Sie an, wo die Projektmappe auf dem Computer des Benutzers installiert.

Erstellen Sie das Setupprojekt auf

  1. In Projektmappen-ExplorerFür Version vorbereiten erweitern Sie den Knoten, und wählen Sie dann die Datei Versionen aus.

  2. Klicken Sie auf der Menüleiste wählen Sie Ansicht, Öffnen aus.

    Der Nur bereinigen Explorer wird in einem Seitenbereich, damit Sie den Typ der Version auswählen können, den Sie erstellen möchten.

  3. Im Nur bereinigen Explorer wählen Sie den Ordner SingleImage aus.

  4. Im Bereich neben dem Nur bereinigen Explorer, wählen Sie die Registerkarte Setup.exe aus.

  5. In der Eigenschaftenseite Setup.exe aus der Liste InstallShield – Speicherort für die erforderlichen Komponenten, wählen Sie Aus Setup.exe extrahieren aus.

  6. Klicken Sie auf der Menüleiste wählen Sie Build, Konfigurations-Manager aus.

  7. In der Liste wählen Sie Konfiguration der aktuellen ProjektmappeSingleImage aus.

  8. In der Tabelle Projektkontexte in der Spalte Konfiguration des Projekts OfficeAddInSetup, wählen Sie SingleImage aus und wählen dann die Schaltfläche Schließen aus.

  9. Klicken Sie auf der Menüleiste wählen Sie Build, OfficeAddInSetup erstellen aus.

    Nachdem der Buildvorgang abgeschlossen ist, können Sie die Bereitstellung des Projekts OfficeAddInSetup am folgenden Speicherort suchen: OfficeAddInSetupProjectRoot\OfficeAddInSetup\Express\SingleImage\DiskImages\DISK1\

Siehe auch

Referenz

Registrierungseinträge für Add-Ins auf Anwendungsebene

Konzepte

Übersicht über benutzerdefinierte Dokumenteigenschaften

Gewähren von Vertrauenswürdigkeit für Office-Projektmappen

Gewähren von Vertrauenswürdigkeit für Dokumente

Weitere Ressourcen

Erforderliche Komponenten für Office-Projektmappen für die Bereitstellung

Bereitstellen einer Office-Projektmappe

Bereitstellen Visual Studio 2010 Tools für Office-Projektmappe mit Windows Installer