db_table
Abre uma tabela OLE DB.
[ db_table(
db_table,
name,
source_name,
hresult
) ]
Parâmetros
db_table
Uma seqüência de caracteres especificando o nome de uma tabela de banco de dados (por exemplo, "produtos").nome (opcional)
O nome do identificador que você usa para trabalhar com a tabela.Você deve especificar esse parâmetro se desejar retornar mais de uma linha de resultados.db_table gera uma variável com o especificado nome que pode ser usado para percorrer o conjunto de linhas ou executar várias consultas de ação.source_name (opcional)
O CSession variável ou instância de uma classe que tem o db_source atributo aplicado a ele no qual o comando será executado.Consulte db_source.hresult(opcional)
Identifica a variável que receberá o HRESULT deste comando de banco de dados.Se a variável não existir, ele será automaticamente injetado pelo atributo.
Comentários
db_table cria um CTable objeto, que é usado por um consumidor de OLE DB para abrir uma tabela.Você pode usar esse atributo apenas no nível de classe; Você não pode usá-lo inline.Use db_column vincular as colunas da tabela a variáveis; Use db_param delimitar (define o tipo de parâmetro e, portanto, em) dos parâmetros.
Quando o provedor de atributo do consumidor aplica esse atributo para uma classe, o compilador irá renomear a classe para _YourClassNameacessador, onde YourClassName é o nome que você deu a classe e o compilador também criará uma classe chamada YourClassName, que é derivada de _YourClassNameacessador.No modo de exibição de classe, você verá as duas classes.
Exemplo
O exemplo a seguir abre a tabela de 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 os exemplos AtlAgent e MultiRead.
Requisitos
Contexto de atributo
Se aplica a |
classe,struct |
Reproduzíveis |
Não |
Atributos obrigatórios |
Nenhum |
Atributos inválidos |
Nenhum |
Para obter mais informações sobre os contextos de atributo, consulte Atributo contextos.