Dokumentschutz in Projektmappen auf Dokumentebene

Artikel
04/28/2010

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 Microsoft Office 2003 2007 Microsoft Office System Weitere Informationen hierzu finden Sie unter Verfügbare Features nach Anwendung und Projekttyp.

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

Microsoft Office 2003
2007 Microsoft Office System

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

In Visual Studio Tools for Office-Projekten können Sie die Schutzfeatures von Microsoft Office Word und Microsoft Office Excel verwenden. Diese verhindern, dass unbefugte Benutzer Änderungen an geschützten Teilen eines Dokuments vornehmen.

Mit Excel können Sie den Schutz aktivieren und deaktivieren, während die Arbeitsmappe im Designer geöffnet ist. Mit Word können Sie den Schutz nur außerhalb des Designers aktivieren. Zur Laufzeit können Sie den Schutz für Word und Excel programmgesteuert aktivieren oder deaktivieren.

Wenn der Dokumentschutz bei einem im Designer geöffneten Dokument aktiviert wird, werden alle Steuerelemente aus der Toolbox entfernt oder deaktiviert, sodass Sie nichts aus dem Datenquellenfenster auf das Dokument ziehen können.

ServerDocument und geschützte Dokumente

Wenn ein Dokument geschützt ist, kann auf den Cache nicht von außerhalb des Dokuments zugegriffen werden. Sie können weder mit ServerDocument im Dokument zwischengespeicherte Daten abrufen oder bearbeiten noch andere Funktionen von ServerDocument verwenden.

Word-Dokumentschutz im Designer

Wenn Sie die Schutzfunktion für ein Word-Dokument oder eine Word-Vorlage aktivieren, während es bzw. sie in Visual Studio geöffnet ist, können Sie den Schutz nicht im Designer erzwingen. Während es in Visual Studio geöffnet ist, befindet sich das Dokument im Entwurfsmodus. Den Schutz können Sie erst erzwingen, wenn es sich im Ausführmodus befindet.

Wenn Sie allerdings ein Visual Studio Tools for Office-Projekt erstellen, das ein vorhandenes Word-Dokument mit aktiviertem Schutz verwendet, ist das Dokument geschützt, während es im Designer geöffnet ist. Seine geschützten Teile können Sie nicht bearbeiten, Sie können aber nach wie vor Code im Code-Editor schreiben, um das Dokument zu automatisieren. Wenn der Schutz aktiviert ist, während das Dokument in Visual Studio geöffnet ist, können Sie auch das Projekt nicht erstellen.

Sie können den Schutz deaktivieren, während das Dokument im Designer geöffnet ist, sodass Sie es bearbeiten und das Projekt erstellen können. Beim Debuggen können Sie den Schutz für die Kopie im Designer nicht deaktivieren. Das Dokument, das beim Debuggen geöffnet wird, ist eine andere Kopie als die im Designer geöffnete (die Ausgabekopie wird bei Visual Basic im Verzeichnis \bin gespeichert, bei C# im Verzeichnis \bin\debug).

Für die Kopie des Dokuments, die im Designer geöffnet wird, können Sie den Schutz aktivieren, indem Sie das Projekt in Visual Studio schließen, die Dokumentkopie aus dem Projektverzeichnis öffnen und den Schutz aktivieren.

Erzwingen des Word-Dokumentschutzes beim Build

Visual Studio Tools for Office erzwingt den Schutz für Word-Dokumente und -Vorlagen beim Buildvorgang, sodass der Schutz aktiviert ist, wenn das Dokument für das Debuggen geöffnet wird. Das Dokument wird mit einem leeren Kennwort geschützt.

Der Schutz wird beim Build aktiviert, damit im Falle, dass es im Startup-Ereignis des Dokuments Code gibt, der möglicherweise Ausnahmen verursacht oder das Anwendungsverhalten ändert, dieser richtig gedebuggt werden kann. Wenn Sie den Schutz nach dem Öffnen des Dokuments aktivieren, kann der Initialisierungscode nicht gedebuggt oder getestet werden.

Festlegen des Kennworts

Visual Studio Tools for Office aktiviert automatisch Schutz, stellt aber standardmäßig kein Kennwort bereit. Wenn der Dokumentschutz mit Kennwort erfolgen soll, müssen Sie das Kennwort vor der Bereitstellung der Projektmappe hinzufügen. Durch Hinzufügen eines Kennworts können Sie Benutzern die Aufhebung des Dokumentschutzes ermöglichen; ohne Kennwort kann der Schutz nicht so leicht aufgehoben werden. Ausführliche Informationen zum Festlegen eines Kennworts finden Sie in der Hilfe der jeweiligen Office-Anwendung.