CFile::CFile

CFile( );

CFile ( int hFile );

CFile ( LPCTSTR lpszFileName, UINT nOpenFlags );
lançar ( CFileException );

Parâmetros

hFile

O identificador de um arquivo que já está aberto.

lpszFileName

Uma Cadeia de caracteres que é o caminho para o arquivo desejado. O caminho pode ser relativo ou absoluto.

nOpenFlags

Modo de compartilhamento e acesso. Especifica a ação a ser tomada quando abrindo o arquivo. Você pode combinar opções listadas abaixo, usando o operador bit a bit ou (|). Permissão de um acesso e uma partilha opção são necessários; o modeCreate e modeNoInherit modos são opcional. Os valores são os seguintes:

CFile::modeCreate Direciona o construtor para criar um novo arquivo. Se o arquivo já existir, ele será truncado para comprimento 0.
CFile::mode&NoTruncatenbsp; Combine esse valor com modeCreate. Se o arquivo está sendo criado já existir, ele não é truncado para comprimento 0. Assim, o arquivo é garantido para abrir, como um arquivo recém-criado ou como um arquivo existente. Isso pode ser útil, por exemplo, ao abrir um arquivo de configurações que pode ou pode não existir já. Esta opção aplica-se a CStdioFile , bem.
CFile:: modeRead Abre o arquivo para leitura apenas.
CFile::modeReadWrite Abre o arquivo para leitura e escrita.
CFile::modeWrite Abre o arquivo para gravação só.
CFile::mode&NoInheritnbsp; Impede que o arquivo está sendo herdado por processos filho.
CFile::shareDeny&Nonenbsp; Abre o arquivo sem negar outros processos ler ou Gravar acessar to o arquivo. Criar falhará se o arquivo tiver sido aberto no modo de compatibilidade por qualquer outro processo.
CFile::shareDe&nyReadnbsp; Abre o arquivo e outro processos Ler denies Acessar to o arquivo. Criar falhará se o arquivo tiver sido aberto no modo de compatibilidade ou para ler acessar por qualquer outro processo.
CFile::shareDe&nyWritenbsp; Abre o arquivo e nega outro processos Gravar acessar to o arquivo. Criar falhará se o arquivo tiver sido aberto no modo de compatibilidade ou para acesso de gravação por qualquer outro processo.
CFile::shareExclusive Abre o arquivo com o modo exclusivo, negando outros processos de leitura e gravação acesso ao arquivo. Construção falhará se o arquivo tiver sido aberto em qualquer outro modo para acesso de leitura ou gravação, até para o processo atual.
CFile::shareCompat Este sinalizador não está disponível em 32 bit MFC. Este sinalizador mapeia para CFile::shareExclusive quando usado em CFile:: abrir.
CFile::typeText Define o modo de texto com processamento especial para carro return – linefeed pares (usado em classes derivadas somente).
CFile::typeBi&narynbsp; Define modo binário (usado em classes derivadas somente).

Observações

O construtor padrão não abriu um arquivo mas sim define m_hFile para CFile::hFileNull. Porque esse construtor não lança uma exceção, não faz sentido usar TRY/CATCH lógica. Use a função de membro Abrir e, em seguida, testar diretamente de condições de exceção. Para uma discussão da estratégia de processamento de exceção, consulte o artigo exceções no Guia do programador do Visual C++.

O Construtor com um argumento cria um objeto de CFile que corresponde a um arquivo existente do sistema operacional identificado pela hFile. Nenhuma verificação é feita sobre o tipo de arquivo ou modo de acesso. Quando o objeto de CFile é destruído, o arquivo de sistema operacional não ser fechado. Você deve fechar o arquivo de si mesmo.

O Construtor com dois argumentos cria um objeto de CFile e abre o arquivo de sistema operacional correspondente com o caminho fornecido. Esse construtor combina as funções do Construtor primeiro e a função de membro Abrir . Ele lança uma exceção se houver um erro ao abrir o arquivo. Geralmente, isso significa que o erro é irrecuperável e que o usuário deve ser alertado.

Exemplo

//exemplo de CFile:: CFile
Char * pFileName = "test.dat";
TENTE
{
   CFile f (pFileName, CFile::modeCreate | CFile::modeWrite);
}
CATCH (CFileException, e)
{
   # ifdef  Debug
      afxDump lt; < "Arquivo não pôde ser aberto" << e-> m_cause << "\n";
   # endif
}
END_CATCH

Visão geral de CFile | Membros de classe | Gráfico de hierarquia

Index