Freigeben über


Übersicht über benutzerdefinierte Dokumenteigenschaften

Wenn Sie ein Projekt auf Dokumentebene erstellen, fügt Visual Studio dem Dokument zwei benutzerdefinierte Eigenschaften im Projekt hinzu: _AssemblyLocation und _AssemblyName. Wenn ein Benutzer ein Dokument öffnet, sucht die Microsoft Office-Anwendung nach diesen benutzerdefinierten Dokumenteigenschaften. Wenn sie im Dokument vorhanden sind, lädt die Anwendung Visual Studio Tools for Office-Laufzeit, die die Anpassung startet. Weitere Informationen finden Sie unter Architektur von Office-Projektmappen in Visual Studio.

Betrifft: Die Informationen in diesem Thema betreffen Projekte auf Dokumentebene für die folgenden Anwendungen: Excel 2007 und Excel 2010, Word 2007 und Word 2010. Weitere Informationen finden Sie unter Verfügbare Funktionen nach Office-Anwendung und Projekttyp.

_AssemblyName

Diese Eigenschaft enthält die CLSID einer Schnittstelle in der Ladeprogrammkomponente der Office-Lösung von Visual Studio Tools for Office-Laufzeit. Der CLSID-Wert ist 4E3C66D5-58D4-491E-A7D4-64AF99AF6E8B. Sie sollten diesen Wert nie ändern.

_AssemblyLocation

Diese Eigenschaft enthält eine Zeichenfolge, die Details über das Bereitstellungsmanifest zur Anpassung bereitstellt. Weitere Informationen zu Manifesten finden Sie unter Anwendungs- und Bereitstellungsmanifeste in Office-Projektmappen.

Der Wert der _AssemblyLocation-Eigenschaft kann abhängig von der Bereitstellung der Projektmappe unterschiedliche Formate besitzen:

  • Wenn die Lösung für die Installation von einer Website, einem UNC-Pfad oder einem CD- oder USB-Laufwerk veröffentlicht wird, besitzt die _AssemblyLocation-Eigenschaft das Format DeploymentManifestPath|SolutionID. Die folgende Zeichenfolge ist ein Beispiel:

    file://deployserver/MyShare/ExcelWorkbook1.vsto|74744e4b-e4d6-41eb-84f7-ad20346fe2d9

  • Wenn Sie die Lösung von Visual Studio aus ausführen oder debuggen, besitzt die _AssemblyLocation-Eigenschaft das Format DeploymentManifestName|SolutionID|vstolocal. Die folgende Zeichenfolge ist ein Beispiel:

    ExcelWorkbook1.vsto|74744e4b-e4d6-41eb-84f7-ad20346fe2d9|vstolocal

Die SolutionID ist eine GUID, die Visual Studio Tools for Office-Laufzeit zum Identifizieren der Lösung verwendet. Die SolutionID wird automatisch generiert, wenn Sie das Projekt erstellen. Durch den vstolocal-Ausdruck wird der Visual Studio Tools for Office-Laufzeit mitgeteilt, dass die Assembly aus demselben Ordner wie das Dokument geladen werden soll.

Siehe auch

Aufgaben

Gewusst wie: Bereitstellen einer Office-Lösung mithilfe von ClickOnce

Gewusst wie: Erstellen und Ändern von benutzerdefinierten Dokumenteigenschaften

Konzepte

Architektur von Anpassungen auf Dokumentebene

Anwendungs- und Bereitstellungsmanifeste in Office-Projektmappen

Weitere Ressourcen

Architektur von Office-Projektmappen in Visual Studio