Classe CFileFind

Artigo
06/10/2015

Executar pesquisas locais de arquivo e é a classe base para CGopherFileFind e CFtpFileFind, que executam pesquisas de arquivo da Internet.

class CFileFind : public CObject

Membros

Construtores public

Nome	Descrição
CFileFind::CFileFind	Constrói um objeto de CFileFind .

Métodos públicos

Nome	Descrição
CFileFind::Close	Fecha a solicitação de pesquisa.
CFileFind::FindFile	Procura um diretório por um nome de arquivo especificado.
CFileFind::FindNextFile	Uma pesquisa continua do arquivo de uma chamada anterior a FindFile.
CFileFind::GetCreationTime	Obtém o tempo que o arquivo foi criado.
CFileFind::GetFileName	Obtém o nome, incluindo a extensão, o arquivo encontrado
CFileFind::GetFilePath	Obtém o caminho para o arquivo encontrado.
CFileFind::GetFileTitle	Obtém o título do arquivo encontrado. o título não inclui a extensão.
CFileFind::GetFileURL	Obtém o URL, incluindo o caminho do arquivo, o arquivo encontrado.
CFileFind::GetLastAccessTime	Obtém o tempo que o arquivo foi acessado pela última vez.
CFileFind::GetLastWriteTime	Obtém o tempo que o arquivo foi modificado pela última vez e salvo.
CFileFind::GetLength	Obtém o tamanho do arquivo encontrado, em bytes.
CFileFind::GetRoot	Obtém o diretório raiz do arquivo encontrado.
CFileFind::IsArchived	Determina se o arquivo é encontrado as.
CFileFind::IsCompressed	Determina se o arquivo encontrado será compactado.
CFileFind::IsDirectory	Determina se o arquivo for encontrado um diretório.
CFileFind::IsDots	Determina se o nome do arquivo localizado tem o nome “.” ou “. ”, indicando que é realmente um diretório.
CFileFind::IsHidden	Determina se o arquivo está oculto encontrado.
CFileFind::IsNormal	Determina se o arquivo localizado é normal (ou seja não tem outros atributos).
CFileFind::IsReadOnly	Determina se o arquivo encontrado é somente leitura.
CFileFind::IsSystem	Determina se o arquivo for encontrado um arquivo do sistema.
CFileFind::IsTemporary	Determina se o arquivo temporário. é encontrado
CFileFind::MatchesMask	Indica os atributos de arquivo desejado do arquivo a ser encontrado.

Métodos protegidos

Nome	Descrição
CFileFind::CloseContext	Fecha o arquivo especificado pelo identificador atual de pesquisa.

Membros de dados protegidos

Nome	Descrição
CFileFind::m_pTM	Ponteiro para um objeto de CAtlTransactionManager .

Comentários

CFileFind inclui funções de membro que começam uma pesquisa, encontra um arquivo, e retornam título, o nome, ou o caminho do arquivo. Para pesquisas da Internet, a função de membro GetFileURL retorna o URL do arquivo.

CFileFind é a classe base para outras duas classes MFC criadas para procurar tipos de servidor específicos: especificamente CGopherFileFind funciona com os servidores de Gopher, e trabalhos de CFtpFileFind especificamente com servidores FTP. Juntas, essas três classes fornecem um mecanismo direto para o cliente localizar arquivos, independentemente do protocolo do servidor, o tipo de arquivo, ou local, em um computador local ou em um servidor remoto.

O código a seguir enumerará todos os arquivos no diretório atual, a impressão o nome de cada arquivo:

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

Para manter o exemplo simples, esse código usa a classe de biblioteca de cout C++ padrão. A linha de cout pode ser substituída por uma chamada a CListBox::AddString, por exemplo, em um programa com uma interface gráfica do usuário.

Para obter mais informações sobre como usar CFileFind e outras classes de WinInet, consulte o artigo Internet que programa com WinInet.