CFileFind Class

Artículo
06/10/2015

Realiza búsquedas de archivos locales y es la clase base para CGopherFileFind y CFtpFileFind, que realizan búsquedas del archivo de Internet.

class CFileFind : public CObject

Members

Constructores públicos

Name	Descripción
CFileFind::CFileFind	Crea un objeto CFileFind.

Métodos públicos

Name	Descripción
CFileFind::Close	Cierra la solicitud de búsqueda.
CFileFind::FindFile	busca un directorio para un nombre de archivo especificado.
CFileFind::FindNextFile	continúa una búsqueda de archivos de una llamada anterior a FindFile.
CFileFind::GetCreationTime	Obtiene el tiempo que el archivo se creó.
CFileFind::GetFileName	Obtiene el nombre, incluida la extensión, el archivo encontrado
CFileFind::GetFilePath	Obtiene la ruta de acceso completa del archivo encontrado.
CFileFind::GetFileTitle	Obtiene el título del archivo encontrado. El título no incluye la extensión.
CFileFind::GetFileURL	Obtiene la dirección URL, incluida la ruta de acceso, el archivo encontrado.
CFileFind::GetLastAccessTime	Obtiene el tiempo que se acceso en último lugar.
CFileFind::GetLastWriteTime	Obtiene el tiempo que el archivo se ha cambiado y que guardado por última vez.
CFileFind::GetLength	Obtiene la longitud del archivo encontrado, en bytes.
CFileFind::GetRoot	Obtiene el directorio raíz del archivo encontrado.
CFileFind::IsArchived	determina si se almacena el archivo encontrado.
CFileFind::IsCompressed	determina si el archivo encontrado es cifrado.
CFileFind::IsDirectory	determina si el archivo encontrado es un directorio.
CFileFind::IsDots	Determina si el nombre del archivo situado tiene el nombre “.” o “. ”, que indica que es realmente un directorio.
CFileFind::IsHidden	Determina si el archivo está oculto encontrado.
CFileFind::IsNormal	determina si el archivo encontrado es normal (es decir no tiene ningún otro atributo).
CFileFind::IsReadOnly	Determina si el archivo encontrado es de solo lectura.
CFileFind::IsSystem	determina si el archivo encontrado es un archivo de sistema.
CFileFind::IsTemporary	determina si el archivo encontrado es temporal.
CFileFind::MatchesMask	Indica los atributos de archivo deseados del archivo que se buscará.

Métodos protegidos

Name	Descripción
CFileFind::CloseContext	Cierre el archivo especificado por el identificador de búsqueda actual.

Miembros de datos protegidos

Name	Descripción
CFileFind::m_pTM	puntero a un objeto de CAtlTransactionManager .

Comentarios

CFileFind incluye las funciones miembro que inicia una búsqueda, busque un archivo, y devuelven el título, el nombre, o la ruta de acceso del archivo. Para las búsquedas de internet, la función GetFileURL miembro devuelve la dirección URL del archivo.

CFileFind es la clase base para otras dos clases MFC diseñadas para buscar tipos de servidor concretos: CGopherFileFind funciona específicamente con los servidores gopher, y CFtpFileFind funciona específicamente con los servidores FTP. Juntas, estas tres clases proporcionan un mecanismo sin problemas para que el cliente buscar archivos, independientemente del protocolo de servidor, el tipo de archivo, o la ubicación, en un equipo local o un servidor remoto.

El código siguiente mostrará todos los archivos del directorio actual, imprime el nombre de cada archivo:

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

para mantener el ejemplo simple, este código utiliza la clase estándar de cout de la biblioteca de C++. La línea de cout se podría reemplazar con una llamada a CListBox::AddString, por ejemplo, en un programa con una interfaz gráfica de usuario.

Para obtener más información sobre cómo utilizar el CFileFind y las clases WinInet, vea el artículo Internet que programa con WinInet.