Freigeben über


Übersicht über benutzerdefinierte Dokumenteigenschaften

Aktualisiert: November 2007

Betrifft

Die Informationen in diesem Thema gelten nur für die angegebenen Projekte und Versionen von Visual Studio Tools for Office von Microsoft Office.

Projekttyp

  • Projekte auf Dokumentebene

Microsoft Office-Version

  • 2007 Microsoft Office System

  • Microsoft Office 2003

Weitere Informationen hierzu finden Sie unter Verfügbare Features nach Anwendung und Projekttyp.

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