Freigeben über

Übersicht über benutzerdefinierte Dokumenteigenschaften

Wenn Sie ein Projekt auf Dokumentebene erstellen, fügt Visual Studio dem Dokument im Projekt zwei benutzerdefinierte Eigenschaften 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 die Visual Studio-Tools für Office-Laufzeit, wodurch die Anpassung gestartet wird. Weitere Informationen finden Sie unter Architektur von Office-Lösungen in Visual Studio.

Gilt für: Die Informationen in diesem Thema gelten für Projekte auf Dokumentebene für Excel und Word. Weitere Informationen finden Sie unter Funktionen verfügbar nach Office-Anwendung und Projekttyp.

_AssemblyName

Diese Eigenschaft enthält die CLSID einer Schnittstelle in der Ladekomponente für Office-Lösungen der Visual Studio Tools für die Office-Laufzeitumgebung. Der CLSID-Wert ist 4E3C66D5-58D4-491E-A7D4-64AF99AF6E8B. Sie sollten diesen Wert niemals ändern.

_AssemblyLocation

Diese Eigenschaft enthält eine Zeichenfolge, die Details zum Bereitstellungsmanifest für die Anpassung bereitstellt. Weitere Informationen zu Manifesten finden Sie unter Anwendungs- und Bereitstellungsmanifesten in Office-Lösungen.

Der Wert der Eigenschaft _AssemblyLocation kann je nach Bereitstellungsart der Lösung unterschiedliche Formate aufweisen.

  • Wenn die Lösung veröffentlicht wird, die von einer Website, einem UNC-Pfad oder einem CD- oder USB-Laufwerk installiert werden soll, weist die _AssemblyLocation-Eigenschaft das Format DeploymentManifestPath|SolutionID auf. Die folgende Zeichenfolge ist ein Beispiel:

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

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

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

    Die SolutionID ist eine GUID, die von den Visual Studio-Tools für Office-Laufzeit verwendet wird, um die Lösung zu identifizieren. Die SolutionID wird automatisch generiert, wenn Sie das Projekt erstellen. Der vstolocal-Terminus gibt an, dass für die Visual Studio-Tools für Office-Laufzeit die Assembly aus demselben Ordner wie das Dokument geladen werden muss.

Verwandte Inhalte

  • Last updated on