Ü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, überprüft die Microsoft Office-App lizenzierung auf diese benutzerdefinierten Dokumenteigenschaften. Wenn sie im Dokument vorhanden sind, lädt die Anwendung die Visual Studio-Tools für Office-Laufzeit, die die Anpassung startet. 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 features available by Office-App lication and project type.

_Assemblyname

Diese Eigenschaft enthält die CLSID einer Schnittstelle in der Office-Lösungsladekomponente der Visual Studio-Tools für Office-Laufzeit. 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 _AssemblyLocation Eigenschaft kann je nach Bereitstellung 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 eigenschaft _AssemblyLocation 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 vom 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-Ausdruck gibt den Visual Studio-Tools für Office-Laufzeit an, dass die Assembly aus demselben Ordner wie das Dokument geladen werden soll.