Métodos gerado pelo Assistente do consumidor

ATL OLE DB consumidor Wizard e o Assistente de aplicativo MFC geram determinadas funções das quais você deve estar ciente. Observe que alguns métodos são implementados de forma diferente no atribuída a projetos, portanto, existem algumas advertências; cada caso é abordado abaixo. Para obter informações sobre como exibir o código injetado, consulte Depurando o código injetado.

• OpenAllAbre a fonte de dados, conjuntos de linhas e ativa indicadores se eles estiverem disponíveis.

• CloseAllversões de todas as execuções de comando e fecha todos os conjuntos de linhas.

• OpenRowseté chamado de OpenAll para abrir o conjunto de linhas ou mais conjuntos do consumidor.

• GetRowsetPropertiesrecupera um ponteiro para a propriedade do conjunto de linhas, definir com quais propriedades podem ser definidas.

• OpenDataSourceAbre a fonte de dados usando a seqüência de inicialização que você especificou na Propriedades de Link de dados caixa de diálogo.

• CloseDataSourceFecha a fonte de dados de maneira apropriada.

OpenAll e CloseAll

HRESULT OpenAll(); 
void CloseAll();

O exemplo a seguir mostra como você pode chamar OpenAll e CloseAll Quando você executa o mesmo comando repetidamente. Compare o exemplo de código em CCommand::Close, que mostra uma variação que chama Fechar e ReleaseCommand em vez de CloseAll.

int main(int argc, char* argv[])
{
   HRESULT hr;

   hr = CoInitialize(NULL);

   CCustOrdersDetail rs;      // Your CCommand-derived class
   rs.m_OrderID = 10248;      // Open order 10248
   hr = rs.OpenAll();         // (Open also executes the command)
   hr = rs.MoveFirst();         // Move to the first row and print it
   printf( "Name: %s, Unit Price: %d, Quantity: %d, Discount %d, Extended Price %d\n", rs.m_ProductName, rs.m_UnitPrice.int64, rs.m_Quantity, rs.m_Discount, rs.m_ExtendedPrice.int64 );

   // Close the first command execution
   rs.Close();


   rs.m_OrderID = 10249;      // Open order 10249 (a new order)
   hr = rs.Open();            // (Open also executes the command)
   hr = rs.MoveFirst();         // Move to the first row and print it
   printf( "Name: %s, Unit Price: %d, Quantity: %d, Discount %d, Extended Price %d\n", rs.m_ProductName, rs.m_UnitPrice.int64, rs.m_Quantity, rs.m_Discount, rs.m_ExtendedPrice.int64 );

   // Close the second command execution;
   // Instead of rs.CloseAll() you could call
   // rs.Close() and rs.ReleaseCommand():
   rs.CloseAll();

   CoUninitialize();
   return 0;
}

Remarks

Observe que, se você definir um HasBookmark método, o OpenAll código define a propriedade DBPROP_IRowsetLocate; certificar-se de que você faça isso apenas se o provedor oferece suporte a essa propriedade.

OpenRowset

// OLE DB Template version: 
HRESULT OpenRowset(DBPROPSET* pPropSet = NULL)
// Attribute-injected version:
HRESULT OpenRowset(const CSession& session, LPCWSTR szCommand = NULL);

OpenAll chama este método para abrir o conjunto de linhas ou conjuntos de linhas no consumidor. Normalmente, você não precisará chamar OpenRowset , a menos que você deseja trabalhar com várias fontes/sessões de dados/conjuntos de linhas. OpenRowseté declarado no arquivo de cabeçalho de classe tabela ou o comando:

// OLE DB Template version:
HRESULT OpenRowset(DBPROPSET *pPropSet = NULL)
{
   HRESULT hr = Open(m_session, NULL, pPropSet);
   #ifdef _DEBUG
   if(FAILED(hr))
      AtlTraceErrorRecords(hr);
   #endif
   return hr;
}

Os atributos implementam este método de forma diferente. Esta versão leva a um objeto de sessão e uma seqüência de caracteres de comando padrão é a seqüência de comandos especificada em db_command, embora você pode passar um diferente. Observe que, se você definir um HasBookmark método, o OpenRowset código define a propriedade DBPROP_IRowsetLocate; certificar-se de que você faça isso apenas se o provedor oferece suporte a essa propriedade.

// Attribute-injected version:
HRESULT OpenRowset(const CSession& session, LPCWSTR szCommand=NULL)
{

   DBPROPSET *pPropSet = NULL;
   CDBPropSet propset(DBPROPSET_ROWSET);
   __if_exists(HasBookmark)

   {
      propset.AddProperty(DBPROP_IRowsetLocate, true);
      pPropSet= &propset;
      }
...
}

GetRowsetProperties

void GetRowsetProperties(CDBPropSet* pPropSet);

Este método recupera um ponteiro para o conjunto de propriedades do conjunto de linhas; Você pode usar esse ponteiro para definir propriedades como, por exemplo, DBPROP_IRowsetChange. GetRowsetPropertiesé usado na classe de registro do usuário da seguinte maneira. Você pode modificar este código para definir as propriedades do conjunto de linhas adicionais:

void GetRowsetProperties(CDBPropSet* pPropSet)
{
   pPropSet->AddProperty(DBPROP_CANFETCHBACKWARDS, true, DBPROPOPTIONS_OPTIONAL);
   pPropSet->AddProperty(DBPROP_CANSCROLLBACKWARDS, true, DBPROPOPTIONS_OPTIONAL);
   pPropSet->AddProperty(DBPROP_IRowsetChange, true, DBPROPOPTIONS_OPTIONAL);
   pPropSet->AddProperty(DBPROP_UPDATABILITY, DBPROPVAL_UP_CHANGE | DBPROPVAL_UP_INSERT | DBPROPVAL_UP_DELETE);
}

Remarks

Você deve definir um global GetRowsetProperties método porque poderia entrar em conflito com aquele definido pelo assistente. Observe que esse é um método gerado pelo assistente que você obtém com projetos de modelo e atribuídos; os atributos não injetar esse código.

OpenDataSource e CloseDataSource

HRESULT OpenDataSource(); 
void CloseDataSource();

Remarks

O assistente define os métodos OpenDataSource e CloseDataSource; OpenDataSourcechamadas CDataSource::OpenFromInitializationString.

Consulte também

Conceitos

A criação de um consumidor de BD OLE usando um assistente