CCommand::Close

Článek
06/10/2015

Vydává přistupující objekt sady řádků přidružené k danému příkazu.

void Close( );

Poznámky

Příkaz používá sadu řádků výsledek přístupový objekt set a (volitelně) přístup k parametru (na rozdíl od tabulky, které nepodporují parametry a nepotřebují přístup k parametru).

Po spuštění příkazu, měli byste zavolat i Close a ReleaseCommand po příkazu.

Pokud chcete opakovaně stejné příkazy, by měl každý přistupující objekt sady výsledků uvolnění voláním Close pomoc Execute.Na konci série, měli přístup k parametru uvolnit voláním ReleaseCommand.Jiným běžným scénářem je volání uložené procedury, která má výstupní parametry.Mnoho poskytovatelů (jako je například zprostředkovatel OLE DB pro SQL Server) hodnoty výstupního parametru nebude přístupná až do uzavření přístupové sady výsledků.Volání Close zavřete vrácených řádků a přístupový objekt set výsledek, ale není parametr přistupujícího objektu, tedy umožňují načíst hodnoty výstupních parametrů.

Příklad

Následující příklad ukazuje, jak můžete volat Close a ReleaseCommand když provádíte opakovaně stejné příkazy.

void DoCCommandTest()
{
   HRESULT hr;

   hr = CoInitialize(NULL);

   CCustomer rs;           // Your CCommand-derived class
   rs.m_BillingID = 6611;  // Open billing ID 6611
   hr = rs.OpenAll();      // (Open also executes the command)
   hr = rs.MoveFirst();    // Move to the first row and print it

   _tprintf_s(_T("First name: %s, Last Name: %s, Customer ID: %d, Postal Code: %s\n"),
      rs.m_ContactFirstName, rs.m_L_Name, rs.m_CustomerID, rs.m_PostalCode);

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

   rs.m_BillingID = 3333;     // Open billing ID 3333 (a new customer)
   hr = rs.Open();            // (Open also executes the command)
   hr = rs.MoveFirst();       // Move to the first row and print it

   _tprintf_s(_T("First name: %s, Last Name: %s, Customer ID: %d, Postal Code: %s\n"),
      rs.m_ContactFirstName, rs.m_L_Name, rs.m_CustomerID, rs.m_PostalCode);

   // Close the second command execution; 
   // Instead of the two following lines 
   // you could simply call rs.CloseAll() 
   // (a wizard-generated method):
   rs.Close();
   rs.ReleaseCommand();

   CoUninitialize();
}

Požadavky

Záhlaví: také atldbcli.h

Viz také

Referenční dokumentace

CCommand – třída

CCommand::ReleaseCommand

Sdílet prostřednictvím