Übersicht über benutzerdefinierte Dokumenteigenschaften

Aktualisiert: November 2007

Wenn ein Dokument Teil einer Anpassung auf Dokumentebene ist, erhält es von Visual Studio Tools for Office zwei benutzerdefinierte Eigenschaften: _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 for Office-Laufzeit, die die Anpassung startet. Weitere Informationen hierzu finden Sie unter Architektur von Visual Studio Tools for Office-Projektmappen.

Die Werte dieser Eigenschaften hängen davon ab, für welche Version von Microsoft Office die Projektmappe vorgesehen ist:

• Die Microsoft Office-Version 2007.

• Die Microsoft Office-Version 2003.

Benutzerdefinierte Eigenschaften für 2007 Microsoft Office-Projektmappen

• _AssemblyName

  Diese Eigenschaft enthält die CLSID einer Schnittstelle im Visual Studio Tools for Office-Ladeprogramm. 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.

Format der _AssemblyLocation-Eigenschaft

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

• Wenn die Projektmappe 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 Projektmappe 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 die Visual Studio Tools for Office-Laufzeit zur Identifizierung der Projektmappe verwendet. Die SolutionID wird beim Erstellen des Projekts automatisch generiert. vstolocal gibt für die Visual Studio Tools for Office-Laufzeit an, dass die Assembly vom gleichen Ordner wie das Dokument geladen werden soll.

Benutzerdefinierte Eigenschaften für Microsoft Office 2003-Projektmappen

• _AssemblyName

  Diese Eigenschaft enthält ein Sternchen (*). Damit wird für die Microsoft Office-Anwendung angegeben, dass das Dokument eine Visual Studio Tools for Office-Anpassung besitzt.

• _AssemblyLocation

  Diese Eigenschaft enthält die GUID des Laufzeitspeicher-Steuerelements. Weitere Informationen finden Sie unter Übersicht über Laufzeitspeicher-Steuerelemente.

Siehe auch

Aufgaben

Gewusst wie: Bereitstellen einer Office-Projektmappe mithilfe von ClickOnce (2007 System)

Gewusst wie: Erstellen und Ändern von benutzerdefinierten Dokumenteigenschaften

Konzepte

Architektur von Anpassungen auf Dokumentebene

Übersicht über Laufzeitspeicher-Steuerelemente

Anwendungs- und Bereitstellungsmanifeste in Office-Projektmappen

Weitere Ressourcen

Architektur von Visual Studio Tools for Office-Projektmappen