CCommand::Close
釋放與命令關聯的存取子資料列集。
void Close( );
備註
命令使用一個資料列集、 結果 set 存取子,以及 (選擇性) 參數存取子 (不同於資料表,它不支援參數並不需要是參數存取子)。
當您執行命令時,您應該呼叫兩者Close和 ReleaseCommand 命令之後。
當您想要重複執行相同的命令時,您應該釋放每個結果集的存取子藉由呼叫Close呼叫之前Execute。 在一系列的最後,您便應該釋放參數存取子藉由呼叫ReleaseCommand。 輸出參數的預存程序呼叫另一個常見的案例。 在多個提供者 (例如 SQL Server 的 OLE DB 提供者) 的輸出參數值將無法存取您必須先關閉結果 set 存取子。 呼叫Close若要關閉傳回的資料列集和結果 set 存取子,但沒有參數存取子,因此可允許您擷取輸出參數值。
範例
下列範例會示範如何呼叫Close和ReleaseCommand當您重複執行相同的命令。
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();
}
需求
標頭: atldbcli.h