VBA-Spezialthema "FileSearch Object"
Allgemeines über das "FileSearch Object"
Übersicht über das FileSearch-Objekt
Methoden und Eigenschaften der FileSearch-Objekte
Programmieren mit dem FileSearch-Objekt
Diese Seite ist teilweise in Bearbeitung! |
Allgemeines über das "FileSearch Object"
Das FileSearch-Objekt ist ein Objekt aus der Microsoft Office-Objektbibliothek. Es dient zum Durchführen einer Dateisuche, wobei man nebst Dateiname und -typ auch Dokument-Eigenschaften spezifizieren kann, die die gesuchte Datei aufweisen muss.
 |
Verwandte Themen |
Übersicht über das FileSearch-Objekt
Die Office-Objektbibliothek besitzt bei Microsoft Office 97 die Bezeichnung "Microsoft Office 8.0 Object Library" und ist in der Datei MSO97.dll abgelegt. Bei Office 2000 lautet ihr Name "Microsoft Office 9.0 Object Library" und befindet sich in der Datei MSO9.dll.
Das FileSearch-Objekt besteht aus insgesamt vier Objekten:
- FileSearch
- FoundFiles
- PropertyTests
- PropertyTest
Methoden und Eigenschaften der FileSearch-Objekte
| Methode | Beschreibung |
| Execute | Beginnt die Suche nach den angegebenen Dateien (Funktion). |
| NewSearch | Setzt die Einstellungen aller Suchkriterien auf die Standardeinstellungen zurück (Prozedur). |
| Eigenschaft | Beschreibung |
| FileName | Gibt den Namen der zu suchenden Datei während der Dateiensuche zurück oder legt ihn fest. Der Dateiname kann auch die Platzhalter * (Stern) oder ? (Fragezeichen) enthalten. |
| FileType | Gibt den Dateityp zurück, nach dem bei einer Dateisuche gesucht werden soll, oder legt den Dateityp fest. Dies kann eine der folgenden MsoFileType-Konstanten sein: msoFileTypeAllFiles, msoFileTypeBinders, msoFileTypeDatabases, msoFileTypeExcelWorkbooks, msoFileTypeOfficeFiles, msoFileTypePowerPointPresentations, msoFileTypeTemplates oder msoFileTypeWordDocuments. Der Standardwert ist msoFileTypeOfficeFiles. |
| FoundFiles | Gibt ein FoundFiles-Objekt zurück, das die Namen aller in einem Suchvorgang gefundenen Dateien enthält. |
| LastModified | Gibt eine Konstante zurück, die den Zeitraum darstellt, vor dem die angegebene Datei zuletzt geändert und gespeichert wurde, oder legt eine Konstante fest. Dies kann eine der folgenden msoLastModified-Konstanten sein: msoLastModifiedAnyTime, msoLastModifiedLastMonth, msoLastModifiedLastWeek, msoLastModifiedThisMonth, msoLastModifiedThisWeek, msoLastModifiedToday oder msoLastModifiedYesterday. Der Standardwert ist msoLastModifiedAnyTime. |
| LookIn | Gibt den Ordner zurück, der während der angegebenen Dateisuche durchsucht werden soll, oder legt den Ordner fest. |
| MatchAllWordForms | True, wenn die angegebene Dateisuche erweitert wird, damit alle Formen des angegebenen Worts im Text der Datei oder in den Eigenschaften der Datei gesucht werden. |
| MatchTextExactly | True, wenn bei der angegebenen Dateisuche nur Dateien gesucht werden sollen, deren Text oder Eigenschaften eine exakte Entsprechung des angegebenen Worts oder Ausdrucks enthalten. |
| PropertyTests | Gibt eine PropertyTests-Auflistung zurück, die alle Suchkriterien für eine Dateisuche darstellt. |
| SearchSubFolders | True, wenn die angegebene Suche alle Unterordner im durch die LookIn-Eigenschaft angegebenen Ordner einschließt. |
| TextOrProperty | Gibt das Wort oder den Ausdruck zurück, nach dem in der angegebenen Dateisuche entweder im Text oder in den Eigenschaften einer Datei gesucht werden soll, oder legt das Wort oder den Ausdruck fest. Das Wort oder der Ausdruck kann als Platzhalter ein * (Stern) oder ein ? (Fragezeichen) enthalten. |
Das FoundFiles-Objekt besitzt keine Methoden.
| Eigenschaft | Beschreibung |
| Count | Enthält die Anzahl der zurückgegebenen Dateien. |
| Methode | Beschreibung |
| Add | Fügt der PropertyTests-Auflistung ein PropertyTest-Objekt hinzu. |
| Remove | Entfernt ein PropertyTest-Objekt aus der PropertyTests-Auflistung. |
Das PropertyTests-Objekt besitzt keine Eigenschaften.
Das PropertyTest-Objekt besitzt keine Methoden.
| Eigenschaft | Beschreibung |
| Condition | Gibt die Bedingung der angegebenen Suchkriterien zurück. |
| Connector | Gibt die Verbindung zwischen zwei gleichartigen Eigenschaftstestwerten zurück. Dies kann eine der folgenden MsoConnector-Konstanten sein: msoConnectorAnd oder msoConnectorOr. Der Standardwert ist msoConnectorAnd. |
| SecondValue | Gibt einen optionalen zweiten Wert des Eigenschaftstests (wie in einem Bereich) für die angegebene Dateisuche zurück. |
| Value | Gibt den Wert eines Eigenschaftstests für eine Dateisuche zurück. |
Programmieren mit dem FileSearch-Objekt
Das Durchführen einer Dateisuche ist mit FileSearch sehr einfach.
With Application.FileSearch
.NewSearch
.LookIn = "C:\Daten"
.SearchSubFolders = True
.FileType = msoFileTypeExcelWorkbooks
If .Execute() > 0 Then
MsgBox "Es wurde(n) " & .FoundFiles.Count & "
Datei(en) gefunden."
For i = 1 To .FoundFiles.Count
MsgBox .FoundFiles(i)
Next i
Else
MsgBox "Es wurden keine Dateien gefunden."
End If
End With
Sub TestLookIn()
Application.DefaultFilePath = "D:\Temp"
MsgBox Application.FileSearch.LookIn
End Sub
Zuletzt aktualisiert am 02.03.2006 / 20:15 Uhr
Zuletzt kontrolliert am 01.01.2009 / 10:00 Uhr
© 2002-2009 by Philipp von Wartburg, Schweiz
