text: "Dsofile.dll" erm�glicht die Bearbeitung der Eigenschaften von Office-Dokumenten aus Visual Basic .NET 2003 und Visual Basic .NET 2002
  Artikel-ID: 224351 - Produkte anzeigen, auf die sich dieser Artikel beziehtDieser Artikel ist eine �bersetzung des folgenden englischsprachigen Artikels der Microsoft Knowledge Base:224351
  (http://support.microsoft.com/kb/224351/EN-US/
  Dsofile.dll lets you edit Office document properties without Office in Visual Basic .NET 2003 and in Visual Basic .NET 2002Bitte beachten Sie: Bei diesem Artikel handelt es sich um eine �bersetzung aus dem Englischen. Es ist m�glich, dass nachtr�gliche �nderungen bzw. Erg�nzungen im englischen Originalartikel in dieser �bersetzung nicht ber�cksichtigt sind. Die in diesem Artikel enthaltenen Informationen basieren auf der/den englischsprachigen Produktversion(en). Die Richtigkeit dieser Informationen in Zusammenhang mit anderssprachigen Produktversionen wurde im Rahmen dieser �bersetzung nicht getestet. Microsoft stellt diese Informationen ohne Gew�hr f�r Richtigkeit bzw. Funktionalit�t zur Verf�gung und �bernimmt auch keine Gew�hrleistung bez�glich der Vollst�ndigkeit oder Richtigkeit der �bersetzung.Wenn Sie ein Kunde mit einem kleinen Unternehmen sind, finden Sie weitere Ressourcen zur Fehlersuche und Schulungen auf der Website Support f�r kleine Unternehmen.Alles erweitern | Alles schlie�enAuf dieser SeiteZusammenfassung
  Die Beispieldatei "Dsofile.dll" ist eine In-Process-ActiveX-Komponente f�r Programmierer, die Microsoft Visual Basic .NET oder das Microsoft .NET Framework verwenden. Mithilfe dieser Komponente k�nnen in benutzerdefinierten Anwendungen unter anderem die OLE-Dokumenteigenschaften der folgenden Microsoft Office-Dateien gelesen und bearbeitet werden:Microsoft Excel-ArbeitsmappenMicrosoft PowerPoint-Pr�sentationenMicrosoft Word-DokumenteMicrosoft Project-ProjekteMicrosoft Visio-ZeichnungenAndere Dateien, ohne dass die dazugeh�rigen Office-Produkte installiert sind Die Beispieldatei "Dsofile.dll" ist in Microsoft Visual C++ erstellt. Sie demonstriert, wie mithilfe der IPropertyStorage-OLE32-Schnittstelle auf die erweiterten Eigenschaften von OLE Structured Storage-Dateien zugegriffen wird. Die Komponente konvertiert die Daten in Automation-f�hige Datentypen, die einfacher von Visual Basic .NET und dem .NET Framework verwendet werden k�nnen. Die Beispieldatei "Dsofile.dll" wird mit vollst�ndigem Quellcode bereitgestellt und beinhaltet in Visual Basic .NET erstellte Beispielclients.Zum Anfang | Ihr Feedback an unsWeitere InformationenDownload der ActiveX-BeispielkomponenteDie folgenden Dateien stehen im Microsoft Download Center zum Download zur Verf�gung:Bild minimierenBild vergr��ernPaket "DsoFileSetup_KB224351_x86.exe" jetzt downloaden.
  (http://www.microsoft.com/downloads/details.aspx?FamilyId=9BA6FAC6-520B-4A0A-878A-53EC8300C4C2&displaylang=en)
  Sie k�nnen die Beispieldatei "Dsofile.dll" und die Visual Basic .NET-Codedateien unentgeltlich nach Belieben verwenden, �ndern, reproduzieren und weitergeben, Ihr Einverst�ndnis vorausgesetzt, dass Microsoft keinerlei Garantie, Verpflichtungen oder Haftung f�r diese Dateien oder die darin bereitgestellten Informationen �bernimmt. Die Komponente und der Quellcode werden kostenlos zu Veranschaulichungszwecken als Beispiel bereitgestellt. Wenn Sie die Komponente ganz oder teilweise in einer Produktionsl�sung verwenden m�chten, tragen Sie die alleinige Verantwortung f�r die �berpr�fung, �nderung und Unterst�tzung der Komponente. Achtung:
  Microsoft stellt Ihnen die Datei "Dsofile.dll" und den dazugeh�rigen Beispielcode ohne Gew�hr auf Richtigkeit, Vollst�ndigkeit und/oder Funktionalit�t, sowie ohne Anspruch auf Support zur Verf�gung und schlie�t jede ausdr�ckliche oder gesetzliche Gew�hrleistung aus, einschlie�lich, aber nicht beschr�nkt auf die gesetzlichen Garantien der Marktg�ngigkeit und/oder der Eignung f�r einen besonderen Zweck. Die Verwendung geschieht auf eigene Verantwortung.
  Informationen zu den OLE-Dokumenteigenschaften Jedes OLE-Verbunddokument kann Zusatzinformationen zum Dokument in persistenten Property Sets speichern, die als Dokumentzusammenfassungseigenschaften bezeichnet werden. Diese Property Sets werden von COM/OLE verwaltet, damit Dritt-Clients diese Informationen ohne Unterst�tzung der Hauptanwendung lesen k�nnen, die f�r die Datei zust�ndig ist. Zur Unterst�tzung von Entwicklern, die Dokumenteigenschaften lesen m�chten, stellt Microsoft zwei Schnittstellen zur Verwaltung von Property Sets zur Verf�gung:IPropertySetStorageIPropertyStorage Jedoch k�nnen Visual Basic .NET-Programmierer diese Schnittstellen nicht direkt nutzen, da sie nicht Automation-kompatibel sind. Um dieses Problem zu umgehen, k�nnen Visual Basic .NET-Entwickler eine ActiveX-DLL, wie die Beispieldatei "DsoFile", zum Lesen und Schreiben der g�ngigsten, in OLE-Verbunddokumenten verwendeten Eigenschaften zu verwenden. Dies trifft insbesondere auf die von Office verwendeten Eigenschaften zu. Hinweis: Die Beispieldatei "Dsofile.dll" wurde speziell zur Verwendung durch Visual Basic .NET-Programmierer erstellt, kann aber aus jeder COM-f�higen Sprache heraus verwendet werden. Verwenden der Komponente "DsoFile" aus einer benutzerdefinierten Anwendung Die Beispieldatei "Dsofile.dll" liest und schreibt die Standardeigenschaften und benutzerdefinierten Eigenschaften jeder beliebigen OLE Structured Storage-Datei. Darunter die der folgenden Dateitypen:Word-DokumenteExcel-ArbeitsmappenPowerPoint-Pr�sentationen Aufgrund ihrer Gr��e und Geschwindigkeit kann die Beispieldatei "Dsofile.dll" viel effizienter arbeiten, als dies beim Automatisieren von Office zum Lesen von Dokumenteigenschaften der Fall w�re. Um die Komponente verwenden zu k�nnen, m�ssen Sie einen Verweis auf die Dsofile-Typbibliothek "DSO OLE Document Properties Reader 2.0" erstellen. Die Komponente kann von sp�t und fr�h gebundenen Aufrufen verwendet werden. Die Beispieldatei "Dsofile.dll" besitzt nur ein erstellbares Objekt. Hierbei handelt es sich um das Objekt DSOFile.OleDocumentProperties. Das Objekt DSOFile.OleDocumentProperties erm�glicht den Zugriff auf die OLE-Dokumenteigenschaften einer von Ihnen geladenen Datei �ber die Methode Open. Alle Eigenschaften werden eingelesen und beim �ffnen zwischengespeichert. Sie werden anschlie�end �ber das Objekt OleDocumentProperties f�r die Bearbeitung zur Verf�gung gestellt. Die Eigenschaften werden erst dann in die Datei zur�ckgeschrieben, wenn Sie die Methode Save aufrufen. Wenn Sie die Bearbeitung einer Datei abgeschlossen haben, rufen Sie Close auf, um die Sperre der Datei aufzuheben.
  Die OLE-Standardeigenschaften und die standardm��igen Office-Zusammenfassungseigenschaften k�nnen aus der Eigenschaft SummaryProperties abgerufen werden. Die benutzerdefinierten Eigenschaften sind in der Auflistung CustomProperties aufgelistet. Jede benutzerdefinierte Eigenschaft besitzt einen eindeutigen Namen. Der Zugriff auf benutzerdefinierte Eigenschaften ist �ber diesen Namen in einer Auflistung m�glich. Sie k�nnen einzelne Eigenschaften hinzuf�gen oder entfernen. Au�erdem haben Sie die M�glichkeit, die gesamte Auflistung mithilfe der "For Each"-Syntax in Visual Basic .NET aufzuz�hlen. Beim Aufruf der Open-Methode versucht das Objekt OleDocumentProperties namens "Dsofile", das Dokument f�r den Lese- und Schreibzugriff zu �ffnen. Wenn die Datei als schreibgesch�tzt gekennzeichnet wurde, oder wenn sich die Datei auf einer NTFS-Freigabe befindet, die nur Lesezugriff gew�hrt, schl�gt der Aufruf eventuell fehl. Die folgende (sinngem��e) Fehlermeldung wird m�glicherweise angezeigt: Fehler 70: Zugriff verweigert(Error 70: Permission denied) Wenn Sie die Datei nur mit Lesezugriff �ffnen wollen, �bergeben Sie f�r den ReadOnly-Parameter der Methode Open den Wert True. Dar�ber hinaus k�nnen Sie das Flag dsoOptionOpenReadOnlyIfNoWriteAccess �bergeben, wenn "Dsofile" versuchen soll, die Datei f�r die Bearbeitung zu �ffnen. Wenn "Dsofile" nicht auf die Datei zugreifen kann, weil sie schreibgesch�tzt oder von einem anderen Prozess gesperrt ist, �ffnen Sie eine schreibgesch�tzte Kopie. Sie k�nnen anschlie�end anhand der Eigenschaft IsReadOnly feststellen, ob das Dokument schreibgesch�tzt ge�ffnet ist.
  Wenn eine Eigenschaft ge�ndert oder modifiziert wurde, k�nnen Sie mithilfe der Eigenschaft IsDirty feststellen, ob die eingestellte Eigenschaft gespeichert werden muss. Vorgenommene �nderungen werden erst beim Aufruf der Methode Save in die Datei geschrieben. Wenn Sie die Methode Save nicht aufrufen, gehen die �nderungen beim Aufruf der Methode Close verloren.
  Zus�tzlich zu den Standard-Automatisierungsfehlermeldungen kann "Dsofile" eine der folgenden benutzerdefinierten Fehlermeldungen erzeugen, wenn etwas nicht funktioniert:Error -2147217151 (&H80041101): You must open a document to perform the action requested.(Fehler -2147217151 (&H80041101): Sie m�ssen ein Dokument �ffnen, um die angeforderte Aktion auszuf�hren.)Error -2147217150 (&H80041102): You must close the current document before opening a new one in the same object.(Fehler -2147217150 (&H80041101): Sie m�ssen das aktuelle Dokument schlie�en, bevor Sie ein neues Dokument in demselben Objekt �ffnen.)Error -2147217149 (&H80041103): The document is in use by another program and cannot be opened for read-write access.(Fehler -2147217149 (&H80041103): Das Dokument wird derzeit von einem anderen Programm verwendet und kann nicht f�r den Lese-/Schreibzugriff ge�ffnet werden.)Error -2147217148 (&H80041104): The document is not an OLE file, and does not support extended document properties.(Fehler -2147217148 (&H80041104): Das Dokument ist keine OLE-Datei und unterst�tzt keine erweiterten Dokumenteigenschaften.)Error -2147217147 (&H80041105): The command is not available because document was opened in read-only mode.(Fehler -2147217147 (&H80041105): Der Befehl ist nicht verf�gbar, weil das Dokument schreibgesch�tzt ge�ffnet ist.)Error -2147217146 (&H80041106): The command is available for OLE Structured Storage files only.(Fehler -2147217146 (&H80041106): Der Befehl ist nur f�r OLE Structured Storage-Dateien verf�gbar.)Error -2147217145 (&H80041107): The object is not connected to the document (it was removed or the document was closed).(Fehler -2147217145 (&H80041107): Das Objekt ist nicht mit dem Dokument verkn�pft (es wurde entweder entfernt oder das Dokument wurde geschlossen).)Error -2147217144 (&H80041108): Cannot access property because the set it belongs to does not exist.(Fehler -2147217144 (&H80041108): Zugriff auf die Eigenschaft nicht m�glich, weil das Set zu dem die Eigenschaft geh�rt, nicht existiert.)Error -2147217143 (&H80041109): The property requested does not exist in the collection.(Fehler -2147217143 (&H80041109): Die angeforderte Eigenschaft existiert nicht in der Auflistung.)Error -2147217142 (&H8004110A): An item by that name already exists in the collection.(Fehler -2147217142 (&H8004110A): Es existiert bereits ein Element mit diesem Namen in der Auflistung.Unicode-Property SetsOLE-Property Sets k�nnen Zeichenfolgen entweder im Unicode-Format oder im MBCS-Format (Multi-Byte Character String, MBCS) mit einer angegebenen Codepage speichern. "Dsofile" kann beide Property Set-Typen lesen und in diese schreiben. Bei der Erstellung neuer Sets, wie etwa beim Hinzuf�gen von Eigenschaften zu einer Datei, die noch keine Eigenschaften besitzt, w�hlt "Dsofile" standardm��ig Unicode. Wenn "Dsofile" das Set unter Verwendung des MBCS-Formats f�r Zeichenfolgen erstellen soll, k�nnen Sie das Flag dsoOptionUseMBCStringsForNewSets in der Methode Open �bergeben.
  Da vorhandene Property Sets eventuell das MBCS-Format verwenden, muss "Dsofile" die Zeichenfolgen bei einem Save-Vorgang im selben Format speichern. Wenn Sie versuchen, eine Zeichenfolge hinzuzuf�gen, die der Codepage f�r das Property Set nicht zugeordnet werden kann, schl�gt der Vorgang eventuell fehl. Daher sollten Sie die Zeichenfolgen auf Zeichen beschr�nken, die in der Codepage des Systems existieren, das die Datei erstellt hat. Stellen Sie alternativ dazu sicher, dass alle Property Sets im Unicode-Format vorliegen, bevor Sie diese Eigenschaften bearbeiten.Hinweis: "Dsofile" konvertiert existierende Property Sets im MBCS-Format nicht in das Unicode-Format. Sie m�ssen die Beispieldatei bearbeiten, wenn Sie diese F�higkeit hinzuf�gen m�chten.Schritte zum Einrichten und Testen der DLL Die selbstextrahierende Setup-Datei installiert die Komponente "DsoFile.dll" an einem Speicherort Ihrer Wahl. Sie installiert au�erdem zwei Visual Basic .NET-Testanwendungen, die die Verwendung der Komponente und des Quellcodes veranschaulichen. Wenn Sie die DLL an einen anderen Speicherort oder auf einen anderen Computer verschieben, m�ssen Sie die DLL (neu) registrieren, bevor Sie sie wieder verwenden k�nnen. Gehen Sie hierzu folgenderma�en vor. Klicken Sie im Men� Start auf Ausf�hren, und geben Sie regsvr32 [Dateipfad]\dsofile.dll im Feld �ffnen ein. Gehen Sie folgenderma�en vor, um das Beispiel auszuf�hren: F�r eine Visual Basic 6.0-Demonstration�ffnen Sie das folgende Visual Basic 6.0-Beispielprojekt:.\Source\Vb6Demo\PropDemo.vbpVergewissern Sie sich, dass "Dsofile.dll" korrekt referenziert wurde. Klicken Sie hierzu im Men� Projekt auf Verweise. Pr�fen Sie, ob f�r DSO OLE Document Properties Reader 2.0 ein Verweis gesetzt wurde.Dr�cken Sie [F5], um das Projekt auszuf�hren. Wenn Sie dazu aufgefordert werden, eine Verbunddokumentdatei zu �ffnen, w�hlen Sie eine geeignete Datei aus. Sie werden feststellen, dass die Dokumenteigenschaften der Datei angezeigt werden.F�r eine Visual Basic .NET 7.0- oder eine Visual Basic .NET 7.1-Demonstration�ffnen Sie das folgende Visual Basic 7.0-Beispielprojekt: .\Source\Vb7Demo\FilePropDemoVB7.sln
  Sie k�nnen dieses Projekt in Visual Basic 7.0 in Visual Studio .NET 2002 oder in Visual Basic 7.1 in Visual Studio .NET 2003 �ffnen.Wenn Sie gefragt werden, ob die L�sung automatisch vom 7.0-Format in das 7.1-Format konvertiert werden soll, klicken Sie auf Ja.Dr�cken Sie die Taste [F5], um das Visual Basic-Projekt zu kompilieren und auszuf�hren.Wenn das Formular angezeigt wird, klicken Sie auf �ffnen. W�hlen Sie eine geeignete Office-Datei aus, und klicken Sie auf OK. Sie werden feststellen, dass die Dokumenteigenschaften der Office-Datei im Dialogfeld angezeigt werden. Sie k�nnen die Dokumenteigenschaften bearbeiten.Zum Anfang | Ihr Feedback an unsInformationsquellen
  Weitere Informationen zum Lesen von Dokumenteigenschaften aus Visual C++ finden Sie in folgendem Artikel der Microsoft Knowledge Base:
  (http://support.microsoft.com/kb/186898/DE/
  Welche Verfahrensweise zu Leseverbunddokumenteigenschaft direkt mit VC++
  Zum Anfang | Ihr Feedback an unsEigenschaftenArtikel-ID: 224351 - Ge�ndert am: Montag, 27. M�rz 2006 - Version: 9.2Die Informationen in diesem Artikel beziehen sich auf:Microsoft Visual Basic .NET 2003 Standard EditionMicrosoft Visual Basic .NET 2002 Standard EditionMicrosoft Visual Basic 6.0 Professional EditionMicrosoft Visual Studio 6.0 Enterprise EditionMicrosoft Office Excel 2003Microsoft Office PowerPoint 2003Microsoft Office Word 2003Microsoft Office Visio Professional 2003Microsoft Office Project Professional 2003Microsoft Excel 2002 Standard EditionMicrosoft PowerPoint 2002 Standard EditionMicrosoft Word 2002 Standard EditionMicrosoft Visio 2002 Professional EditionMicrosoft Project 2002 Standard EditionKeywords:�
  kbdownload kbautomation kbfile kbinfo kbpersistst KB224351Microsoft stellt Ihnen die in der Knowledge Base angebotenen Artikel und Informationen als Service-Leistung zur Verf�gung. Microsoft �bernimmt keinerlei Gew�hrleistung daf�r, dass die angebotenen Artikel und Informationen auch in Ihrer Einsatzumgebung die erw�nschten Ergebnisse erzielen. Die Entscheidung dar�ber, ob und in welcher Form Sie die angebotenen Artikel und Informationen nutzen, liegt daher allein bei Ihnen. Mit Ausnahme der gesetzlichen Haftung f�r Vorsatz ist jede Haftung von Microsoft im Zusammenhang mit Ihrer Nutzung dieser Artikel oder Informationen ausgeschlossen.