db_table

Abre uma tabela do OLE DB.

Sintaxe

[ db_table(db_table, name, source_name, hresult) ]

Parâmetros

db_table
Uma cadeia de caracteres que especifica o nome de uma tabela de banco de dados (como "Produtos").

name
(Opcional) O nome do identificador usado para trabalhar com a tabela. Você deve especificar esse parâmetro se quiser retornar mais de uma linha de resultados. db_table gera uma variável com o name especificado que pode ser usado para percorrer o conjunto de linhas ou executar várias consultas de ação.

source_name
(Opcional) A variável CSession ou instância de uma classe que tem o atributo db_source aplicado a ela na qual o comando é executado. Consulte db_source.

hresult
(Opcional) Identifica a variável que receberá o HRESULT desse comando de banco de dados. Se a variável não existir, ela será injetada automaticamente pelo atributo.

Comentários

db_table cria um objeto CTable, que é usado por um consumidor OLE DB para abrir uma tabela. É possível usar esse atributo somente no nível da classe; não é possível usá-lo embutido. Use db_column para associar colunas de tabela a variáveis; use db_param para delimitar (definir o tipo de parâmetro e assim por diante) dos parâmetros.

Quando o provedor de atributos de consumidor aplica esse atributo a uma classe, o compilador renomeia a classe como _YourClassNameAccessor, em que YourClassName é o nome que você deu à classe, e o compilador também criará uma classe chamada YourClassName, que deriva de _YourClassNameAccessor. No Modo de Exibição de Classe, você verá ambas as classes.

Exemplo

O exemplo a seguir abre a tabela Produtos para uso por CProducts.

// db_table.cpp
// compile with: /LD
#include <atlbase.h>
#include <atlplus.h>
#include <atldbcli.h>

[ db_table(L"dbo.Products") ]
class CProducts {
   [ db_column("1") ] LONG m_ProductID;
};

Para obter um exemplo desse atributo usado em um aplicativo, consulte MultiRead.

Requisitos

Contexto do atributo	Valor
Aplicável ao	class, struct
Repetível	Não
Atributos necessários	Nenhum
Atributos inválidos	Nenhum

Para obter mais informações sobre os contextos de atributo, confira Contextos de atributo.

Confira também

Atributos de consumidor do OLE DB