db_param

Associa a variável de membro especificada com um parâmetro de entrada ou de saída e delimita a variável.

[ db_param( 
   ordinal, 
   paramtype="DBPARAMIO_INPUT", 
   dbtype, 
   precision, 
   scale, 
   status, 
   length
) ]

Parâmetros

• ordinal
  O número da coluna (DBCOLUMNINFO ordinal) correspondente a um campo no conjunto de linhas ao qual vincular a dados.

• paramtype (opcional)
  O tipo a ser definido para o parâmetro.Provedores aceitam somente tipos de i/O parâmetro que são suportados pela fonte de dados subjacente.O tipo é uma combinação de um ou mais DBPARAMIOENUM valores:

  • DBPARAMIO_INPUT um parâmetro de entrada.

  • DBPARAMIO_OUTPUT um parâmetro de saída.

  • DBPARAMIO_NOTPARAM o acessador não tem parâmetros.Definindo eParamIO para esse valor na linha acessadores lembra o usuário que os parâmetros são ignorados.

• DbType (opcional)
  Um OLE DB Indicador do tipo para a entrada de coluna.

• Precision (opcional)
  A precisão a ser usado para a entrada de coluna.Para obter detalhes, consulte a descrição do bPrecision elemento da estrutura DBBINDING

• escala (opcional)
  A escala a ser usado para a entrada de coluna.Para obter detalhes, consulte a descrição do bScale elemento da estrutura DBBINDING

• status (opcional)
  Uma variável de membro usada para manter o status desta coluna.O status indica se o valor da coluna é um valor de dados ou algum outro valor, como Nulo.Para obter valores possíveis, consulte Status na referência OLE DB Programmer.

• comprimento de (opcional)
  Uma variável de membro usada para manter o tamanho da coluna em bytes.

Comentários

db_param define os parâmetros que você usa comandos; portanto você usá-lo com db_command.Por exemplo, você pode usar db_param a ligação dos parâmetros no SQL consultas ou procedimentos armazenados.Parâmetros em um procedimento armazenado são indicados por pontos de interrogação (?), e você deve vincular os membros de dados na ordem em que os parâmetros são exibidos.

db_param delimita os dados de membros que podem participar do OLE DB ICommandWithParameters-com base em ligação.Ele define o tipo de parâmetro (entrada ou saída), o tipo de banco de dados OLE, precisão, escala, status e comprimento para o parâmetro especificado.Este atributo insere as macros do consumidor de OLE DB BEGIN_PARAM_MAP...END_PARAM_MAP.Cada membro que você marcou com o db_param atributo ocupará uma entrada no mapa na forma de um COLUMN_ENTRY.

db_param é usado em conjunto com um a db_table ou db_command atributos.

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 cria uma classe de comando com base no procedimento SalesbyYear armazenado no banco de dados Northwind.Ele associa o primeiro parâmetro no procedimento armazenado com o m_RETURN_VALUE variável e a define como um parâmetro de saída.Ele associa os dois últimos parâmetros (input) com m_Beginning_Date e m_Ending_Date.

O exemplo a seguir associa o nOutput variável com um parâmetro de saída.

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

[ db_source(L"my_connection_string"), 
  db_command(L"{ ? = CALL dbo.\"Sales by Year\"(?,?) }") 
]
struct CSalesbyYear {
   DBSTATUS m_dwShippedDateStatus;
   DBSTATUS m_dwOrderIDStatus;
   DBSTATUS m_dwSubtotalStatus;
   DBSTATUS m_dwYearStatus;

   DBLENGTH m_dwShippedDateLength;
   DBLENGTH m_dwOrderIDLength;
   DBLENGTH m_dwSubtotalLength;
   DBLENGTH m_dwYearLength;

   // Bind columns
   [ db_column("1", status="m_dwShippedDateStatus", length="m_dwShippedDateLength") ] DBTIMESTAMP m_ShippedDate;
   [ db_column("2", status="m_dwOrderIDStatus", length="m_dwOrderIDLength") ] LONG m_OrderID;
   [ db_column("3", status="m_dwSubtotalStatus", length="m_dwSubtotalLength") ] CURRENCY m_Subtotal;
   [ db_column("4", status="m_dwYearStatus", length="m_dwYearLength") ] TCHAR m_Year[31];

   // Bind parameters
   [ db_param("1", paramtype="DBPARAMIO_OUTPUT") ] LONG m_RETURN_VALUE;
   [ db_param("2", paramtype="DBPARAMIO_INPUT") ] DBTIMESTAMP m_Beginning_Date;
   [ db_param("3", paramtype="DBPARAMIO_INPUT") ] DBTIMESTAMP m_Ending_Date;
};

Requisitos

Contexto de atributo

Para obter mais informações sobre os contextos de atributo, consulte Atributo contextos.

Consulte também

Outros recursos

OLE DB consumidor atributos

Attributes Samples