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 obrigatórios | Nenhum |
| Atributos inválidos | Nenhum |
Para obter mais informações sobre os contextos de atributo, confira Contextos de atributo.