CFileFind-Klasse

Artikel
06/10/2015

Führt lokale Dateisuchen aus und ist die Basisklasse für CGopherFileFind und CFtpFileFind, die Internetdateisuchen ausführen.

class CFileFind : public CObject

Mitglieder

Öffentliche Konstruktoren

Name	Description
CFileFind::CFileFind	Erstellt ein CFileFind-Objekt.

Öffentliche Methoden

Name	Description
CFileFind::Close	Enthält die Anforderung.
CFileFind::FindFile	Sucht in einem Verzeichnis für einen angegebenen Dateinamen.
CFileFind::FindNextFile	Fügt eine Dateisuche aus einem früheren Aufruf FindFile fort.
CFileFind::GetCreationTime	Ruft die Zeit ab, die die Datei erstellt wurde.
CFileFind::GetFileName	Ruft den Namen, einschließlich der Erweiterung, der gesuchten Datei ab
CFileFind::GetFilePath	Ruft den vollständigen Pfad der gesuchten Datei ab.
CFileFind::GetFileTitle	Ruft den Titel der gesuchten Datei ab. Der Name enthält keine Erweiterung.
CFileFind::GetFileURL	Ruft die URL, einschließlich den Dateipfad, der gesuchten Datei ab.
CFileFind::GetLastAccessTime	Ruft die Zeit ab, die auf die Datei zuletzt verwendet wurden.
CFileFind::GetLastWriteTime	Ruft die Zeit ab, die die Datei zuletzt geändert und gespeichert wurde.
CFileFind::GetLength	Ruft die Länge der gesuchten Datei, in Bytes ab.
CFileFind::GetRoot	Ruft das Stammverzeichnis der gesuchten Datei ab.
CFileFind::IsArchived	Bestimmt, ob die gesuchte Datei protokolliert wird.
CFileFind::IsCompressed	Bestimmt, ob die gesuchte Datei komprimiert wird.
CFileFind::IsDirectory	Bestimmt, ob die gesuchte Datei ein Verzeichnis befindet.
CFileFind::IsDots	Bestimmt, ob der Name der gesuchten Datei hat den Namen "." oder ". ", angibt, das eigentlich ein Verzeichnis befindet.
CFileFind::IsHidden	Bestimmt, ob die gesuchte Datei ausgeblendet ist.
CFileFind::IsNormal	Bestimmt, ob die gesuchte Datei normal ist (das heißt, hat keine anderen Attribute).
CFileFind::IsReadOnly	Bestimmt, ob die gesuchte Datei schreibgeschützt ist.
CFileFind::IsSystem	Bestimmt, ob die gesuchte Datei eine Systemdatei ist.
CFileFind::IsTemporary	Bestimmt, ob die gesuchte Datei temporär ist.
CFileFind::MatchesMask	Gibt die gewünschte Dateiattribute der zu durchsuchenden Datei an.

Geschützte Methoden

Name	Description
CFileFind::CloseContext	Enthält die Datei, die vom aktuellen Suchenhandle angegeben wird.

Geschützte Datenmember

Name	Description
CFileFind::m_pTM	Zeiger auf einen CAtlTransactionManager-Objekt.

Hinweise

CFileFind enthält Memberfunktionen ein, die eine Suche starten, eine Datei suchen und den Titel, den Namen oder den Pfad der Datei zurückgeben. Für Internet-Suchen gibt die Memberfunktion GetFileURL die URL der Datei zurück.

CFileFind ist die Basisklasse für zwei weitere MFC-Klassen, die entwickelt wurden, um Typen des bestimmten Servers zu suchen: CGopherFileFind funktioniert speziell mit Gopherservern und CFtpFileFind Arbeiten speziell mit FTP-Servern. Zusammen ergeben diese drei Klassen einen nahtlosen Mechanismus bereit, damit der Client Dateien, unabhängig vom Serverprotokoll, den Dateityp oder Speicherort, entweder auf einem lokalen Computer oder einem Remoteserver sucht.

Im folgenden Code werden alle Dateien im aktuellen Verzeichnis auf und gibt den Namen jeder Datei:

CFileFind finder;
BOOL bWorking = finder.FindFile(_T("*.*"));
while (bWorking)
{
   bWorking = finder.FindNextFile();
   TRACE(_T("%s\n"), (LPCTSTR)finder.GetFileName());
}

Um das Beispiel einfach zu übergeben, verwendet dieser Code die cout-Standard-C++-Bibliotheksklasse. Die cout Zeile kann durch einen Aufruf CListBox::AddString beispielsweise in ein Programm ersetzt werden mit einer grafischen Benutzeroberfläche.

Weitere Informationen dazu, wie CFileFind und die anderen WinInet-Klassen, finden Sie im Artikel Webprogrammierung mit WinInet-Klassen verwendet.