Übersicht über benutzerdefinierte Dokumenteigenschaften

  • Artikel

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 für 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 2013 und Excel 2010, Word 2013 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 für 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 für Office-Laufzeit zum Identifizieren der Lösung verwendet.SolutionID wird automatisch generiert, wenn Sie das Projekt erstellen. Der vstolocal Begriff zu Visual Studio-Tools für Office-Laufzeit gibt an, dass die Assembly im gleichen Ordner wie das Dokument geladen werden soll.

Siehe auch

Aufgaben

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

Gewusst wie: Veröffentlichen einer Office-Projektmappe mit ClickOnce