Assistente de consumidor de BD OLE ATL

Artigo
08/01/2011

Este assistente configura uma classe de consumidor do OLE DB com as ligações de dados necessário para acessar a fonte de dados especificada por meio do provedor do OLE DB especificado.

Observação
Este assistente requer que você clique o Fonte de dados botão para selecionar uma fonte de dados antes de inserir os nomes a Class e . h arquivo campos.

Data Source
O A fonte de dados botão permite que você configure a fonte de dados especificada usando o provedor do OLE DB especificado. Quando você clica neste botão, o Propriedades de Link de dados caixa de diálogo aparece. Para obter mais informações sobre a criação de seqüências de conexão e o Data Link Properties caixa de diálogo, consulte Visão geral de API de Link de dados na Windows SDK documentação.

Observação
Em versões anteriores, clicando em Shift a A fonte de dados botão aberta uma caixa de diálogo Abrir arquivo para permitir que você selecione um arquivo de vínculo de dados (. udl). Essa funcionalidade não é mais suportada.

A caixa de diálogo possui quatro guias:

Provedor guia
Conexão guia
Advanced guia

Todos os guia

As informações adicionais a seguir descrevem as guias de Propriedades de Link de dados caixa de diálogo.

Clique em OK para concluir. O Selecionar objeto de banco de dados caixa de diálogo aparece. Esta caixa de diálogo, selecione a tabela, modo de exibição ou procedimento armazenado que usará o consumidor.

Provider
Selecione um provedor apropriado para gerenciar a conexão com a fonte de dados. O tipo de provedor normalmente é determinado pelo tipo de banco de dados ao qual você está se conectando. Clique na Next botão ou clique o conexão guia.

Connection
O conteúdo desta guia depende do provedor selecionado. Embora existam muitos tipos de provedores, esta seção aborda conexões para as duas mais comuns: Dados SQL e ODBC. Os outros são semelhantes variações nos campos descritos aqui.

Para dados SQL:

Selecione ou digite um nome de servidor: Clique no menu de lista suspensa para exibir todos os servidores de dados registrado na rede e selecione uma.
Insira informações para efetuar logon no servidor: Digite um nome de usuário e senha para fazer logon no servidor de dados.

Selecione o banco de dados no servidor: Clique no menu de lista suspensa para exibir registrados de todos os bancos de dados do servidor de dados e selecione uma.

- ou -

Anexe um arquivo de banco de dados como um nome de banco de dados: Especificar um arquivo a ser usado como banco de dados; Digite o nome do caminho explícito.

Observação
Há um problema de segurança com "Permitir salvamento de senhas" recurso da caixa de diálogo Propriedades do Link de dados. Em "Informações de Enter para fazer logon no servidor" Existem dois botões de opção:

Use Windows NT integrated security

Use a specific user name and password

Se você selecionar usar um nome de usuário específico e senha, você tem a opção de salvar a senha (usando a caixa de seleção para "Permitir salvar senha"); No entanto, essa opção não é segura. É recomendável que você selecione a segurança integrada do uso de Windows NT; Essa opção é segura porque ele criptografa a senha.

Pode haver situações em que você deseja selecionar 'Permitir salvar senha'. Por exemplo, se a liberação de uma biblioteca com uma solução de banco de dados particular, não acessam o banco de dados diretamente mas em vez disso, use um aplicativo de camada intermediária para verificar o usuário (por meio de qualquer esquema de autenticação escolhido) e, em seguida, limitar a classificação de dados disponíveis para o usuário.

Para dados ODBC:

1. Especifique a fonte de dados: Você pode usar um nome de fonte de dados ou uma seqüência de conexão.

Use o nome da fonte de dados: Esta lista drop-down exibe as fontes de dados registrados no computador. Você pode configurar fontes de dados antes do tempo usando o ODBC Data Source Administrator. - ou -usar a seqüência de conexão: Digite uma seqüência de conexão que você já tiver sido obtido ou clique o Build botão; o Selecionar fonte de dados caixa de diálogo aparece. Selecione uma fonte de dados do arquivo ou máquina e clique em OK.

Observação
Você pode obter uma seqüência de conexão, exibindo as propriedades de uma conexão existente no Server Explorer, ou você pode criar uma conexão clicando duas vezes em Add Connection no Server Explorer.

2. Insira informações para efetuar logon no servidor: Digite um nome de usuário e senha para fazer logon no servidor de dados.

3. Insira o catálogo inicial a ser usado.

4. Clique em Test Connection; Se o teste for bem-sucedida, clique em OK. Caso contrário, verifique as informações de logon, tente outro banco de dados ou tente outro servidor de dados.

Advanced
Configurações de rede: Especificar o Impersonation level (o nível de representação que o servidor tem permissão para usar ao representar o cliente; corresponde diretamente para os níveis de representação de RPC) e o nível de proteção (o nível de proteção de dados enviados entre cliente e servidor; corresponde diretamente para os níveis de proteção de RPC).

Outros: Em Connect timeout, especifique o número de segundos de tempo ocioso antes que ocorra um tempo limite. Em as permissões de acesso, especifique as permissões de acesso na conexão de dados.

For more information about advanced initialization properties, refer to the documentation provided with each specific OLE DB provider.
All
Esta aba exibe um resumo das propriedades de inicialização para a fonte de dados e a conexão que você especificou. Você pode editar esses valores.

Class
Depois de selecionar uma fonte de dados, esta caixa é preenchida com um nome de classe padrão com base na tabela ou procedimento armazenado que você selecionou (consulte Selecionar uma fonte de dados abaixo). Você pode editar o nome da classe.
arquivo. h
Depois de selecionar uma fonte de dados, esta caixa é preenchida com um nome de classe do cabeçalho padrão com base na tabela ou procedimento armazenado que você selecionou (consulte Selecionar uma fonte de dados abaixo). Você pode editar o nome do arquivo de cabeçalho ou selecionar um arquivo de cabeçalho existente.

Atribuído
Essa opção especifica se o assistente irá criar classes de consumidor usando atributos ou declarações do modelo. Quando você seleciona essa opção, o assistente usa atributos em vez de declarações do modelo (isso é a opção padrão). Quando você desmarcar essa opção, o assistente usa declarações do modelo em vez de atributos.

Se você selecionar um consumidor tipo de da tabela, o assistente usa o db_source e db_table atributos para criar a tabela e o acessador de tabela de declarações de classe e a usa db_column para criar o mapa de coluna, por exemplo:

// Inject table class and table accessor class declarations
[
    db_source("<initialization_string>"),
    db_table("dbo.Orders")
]
...
// Column map
    [ db_column(1, status=m_dwOrderIDStatus,         length=m_dwOrderIDLength) ] LONG m_OrderID;
    [ db_column(2, status=m_dwCustomerIDStatus,         length=m_dwCustomerIDLength) ] TCHAR m_CustomerID[6];
    ...

em vez de usar o CTable a classe de modelo para declarar a tabela e classe de assessor de tabela e as macros BEGIN_COLUMN_MAP e END_COLUMN_MAP para criar o mapa de coluna, por exemplo:

// Table accessor class
class COrdersAccessor;
// Table class
class COrders : public CTable<CAccessor<COrdersAccessor> >;
...
// Column map
BEGIN_COLUMN_MAP(COrderDetailsAccessor)
    COLUMN_ENTRY_LENGTH_STATUS(1, m_OrderID,         m_dwOrderIDLength, m_dwOrderIDStatus)
    COLUMN_ENTRY_LENGTH_STATUS(2, m_CustomerID,         m_dwCustomerIDLength, m_dwCustomerIDStatus)
    ...
END_COLUMN_MAP()

Se você selecionar um consumidor tipo de de comando, o assistente usa o db_source e db_command atributos e usa db_column para criar o mapa de coluna, por exemplo:

[
    db_source("<initialization_string>"),
    db_command("SQL_command")
]
...
// Column map using db_column is the same as for consumer type of 'table'

em vez de usar o comando e declarações de classe de assessor de comando na classe de comando arquivo. h, por exemplo:

Command accessor class:
class CListOrdersAccessor;
Command class:
class CListOrders : public CCommand<CAccessor<CListOrdersAccessor> >;
...
// Column map using BEGIN_COLUMN_MAP ... END_COLUMN_MAP is the same as
// for consumer type of 'table'

See Basic Mechanics of Attributes for more information.

Type
Selecione um desses botões de rádio para especificar se a classe de consumidor será derivada CTable ou CCommand (padrão).
- Table
  Selecione esta opção se você deseja usar CTable ou db_table para criar a tabela e o acessador de tabela de declarações de classe.
- Command
  Selecione esta opção se você deseja usar CCommand ou db_command para criar o acessador de comando e o comando declarações de classe. Esta é a seleção padrão.
Support
Marque as caixas de seleção para especificar os tipos de atualizações para que sejam compatíveis com o consumidor (o padrão é none). Cada um dos seguintes definirá DBPROP_IRowsetChange e as entradas apropriadas para DBPROP_UPDATABILITY na propriedade definida no mapa.
- Change
  Especifica que o consumidor suporte a atualizações de dados de linha no conjunto de linhas.
- Insert
  Especifica que o consumidor oferecem suporte a inserção de linhas no conjunto de linhas.
- Delete
  Especifica que o consumidor oferecem suporte a exclusão de linhas do conjunto de registros.

Consulte também

Compartilhar via

Assistente de consumidor de BD OLE ATL

Consulte também

Tarefas

Referência

Conceitos

Recursos adicionais