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.

Consulte também

Outros recursos

OLE DB consumidor atributos

Attributes Samples