CDaoDatabase::Open

virtual void Open (LPCTSTR lpszName, BOOL bExclusive = FALSE, BOOL bReadOnly = FALSE, LPCTSTR lpszConnect = _T(""));
lançar (CDaoException, CMemoryException);

Parâmetros

lpszName

Uma expressão em seqüência que é o nome de um existente Microsoft Jet (.Arquivo de banco de dados MDB). O nome do arquivo possui uma extensão, se necessário. Se sua rede oferecer suporte a uniform naming convention (UNC), você também pode especificar um caminho de rede, tais como "\\\\MYSERVER\\MYSHARE\\MYDIR\\MYDB.MDB". (Duplo barras invertidas são necessárias em literais de Cadeia de caracteres como "\" é o caractere de escape do C++.)

Algumas considerações se aplicam ao usar lpszName. Se ele:

bExclusive

Um valor booleano que é TRUE se o banco de dados deve ser aberto para acesso exclusivo (não compartilhado) e FALSE se o banco de dados deve ser aberto para acesso compartilhado. Se você omitir esse argumento, o banco de dados é aberto para acesso compartilhado.

bReadOnly

Um valor booleano que é TRUE se o banco de dados deve ser aberto para acessar read-only e FALSE se o banco de dados deve ser aberto para acesso de leitura/gravação. Se você omitir esse argumento, o banco de dados é aberto para acesso de leitura/gravação. Todos os conjuntos de registros dependentes herdarão esse atributo.

lpszConnect

Uma expressão de Cadeia de caracteres usada para abrir o banco de dados. Essa seqüência constitui o ODBC ligar argumentos. Você precisará fornecer os argumentos exclusivos e somente leitura para fornecer uma Cadeia de caracteres de origem. Para sintaxe, consulte o tópico "Propriedade conectar-se" na Ajuda do DAO. Se o banco de dados é um banco de dados Microsoft Jet (.MDB), este seqüência de caracteres é vazia (""). A sintaxe para o valor padrão — t("") — fornece portabilidade de Unicode, bem como ANSI compilações do seu aplicativo.

Observações

Você deve chamar essa função de membro para inicializar um objeto de CDaoDatabase recém-construído que representa um banco de dados existente. Open associa o banco de dados do objeto DAO subjacente. Você não pode usar o objeto de banco de dados para construir o conjunto de registros, tabledef ou querydef objetos até que ele é inicializado. Open anexa o objeto de banco de dados à coleção de bancos de dados do espaço de trabalho associado.

Use os parâmetros como segue:

Para obter informações relacionadas, consulte o tópico "Método OpenDatabase" na Ajuda do DAO.

Importa&ntenbsp;  Para um melhor desempenho ao acessar bases de dados externas, incluindo bancos de dados ISAM e fontes de dados ODBC, é recomendável que você anexar tabelas de banco de dados externo para um banco de dados mecanismo Microsoft Jet (.MDB) em vez de conectar-se diretamente à fonte de dados.

É possível para uma tentativa de conexão para o tempo limite se, por exemplo, o host do DBMS não estiver disponível. Se a tentativa de conexão falhar, Open lança uma exceção do tipo CDaoException.

As restantes observações se aplicam apenas aos bancos de dados ODBC:

Se o banco de dados é um banco de dados ODBC e os parâmetros no seu convite aberto não contêm informações suficientes para fazer a conexão, o driver ODBC abre uma caixa de diálogo para obter as informações necessárias do usuário. Quando você chama Abrir, sua seqüência de conexão, lpszConnect, é armazenada de maneira segura e está disponível por chamado a função de membro GetConnect.

Se desejar, você pode abrir sua própria caixa de diálogo antes de chamar Abrir para obter informações do usuário, such as uma senha, em seguida, adicionar essa informação à cadeia de conexão que você passar para Abrir. Ou você talvez queira salvar a seqüência de conexão que você passar (talvez no registro do Windows) assim que você pode reutilizá-la na próxima vez que o aplicativo chama aberta em um objeto de CDaoDatabase.

Você também pode usar a seqüência de conexão para vários níveis de autorização de início de sessão (cada um para um objeto de CDaoDatabase diferente) ou transmitir outras informações específicas do banco de dados.

Para obter informações relacionadas sobre como conectar-se seqüências de caracteres, consulte o tópico "Propriedade conectar-se" na Ajuda do DAO.

Visão geral de CDaoDatabaseMembros de classe | Gráfico de hierarquia

Co&nsulte tambémnbsp;CDatabase::CDatabase, CDatabase::Close

Index