Zestawy wierszy

zestaw wierszy jest zbiór wierszy, które zawierają kolumny danych.Zestawów wierszy są obiektami centralnej, umożliwiające wszystkich dostawców danych OLE DB do udostępnienia danych zestaw wyników w formie tabeli.

Po konsument tworzy sesja za pomocą IDBCreateSession::CreateSession metoda, konsument można użyć albo IOpenRowset or IDBCreateCommand interfejs sesja do utworzenia zestawu zestaw wierszy.The SQL Server Native klient OLE DB dostawca supports both of these interfaces. Obie te metody są opisane w tym miejscu.

• Tworzenie zestawu zestaw wierszy, wywołując IOpenRowset::OpenRowset metoda.

  To jest równoznaczne z utworzeniem zestawu zestaw wierszy w jednej tabela.Ta metoda zostanie otwarty i zwraca zestaw wierszy, zawierającą wszystkie wiersze z jednej tabela bazowa.Jeden z argumentów funkcji OpenRowset jest identyfikator tabela, który identyfikuje tabela, z którym chcesz utworzyć zestaw wierszy.

• Tworzenie obiektu polecenia, wywołując IDBCreateCommand::CreateCommand metoda.

  Obiekt polecenie wykonuje polecenia, które obsługuje dostawca.Z SQL Server Macierzysta klient OLE DB, konsument można określić dowolny Transact-SQL zestawienie, takie jak instrukcja SELECT lub wywołanie procedura przechowywana. Kroki tworzenia zestawu zestaw wierszy za pomocą obiektu polecenia to:

  1. Wywołania konsumenta IDBCreateCommand::CreateCommand Metoda sesja uzyskać obiektu polecenia, żądając ICommandText interfejs dla obiektu polecenia.To ICommandText interfejs ustawia i pobiera tekst polecenia rzeczywiste.Konsument wprowadza w poleceniu tekstowym wywołując ICommandText::SetCommandText metoda.

  2. Wywołania użytkownika ICommand::wykonać metoda na polecenia.Obiekt zestaw wierszy, wbudowane podczas wykonywania polecenia zawiera polecenie zestaw wyników.

Konsument może używać ICommandProperties Interfejs uzyskać lub ustawić właściwości dla zestaw wierszy zwracanych przez polecenie, wykonane przez ICommand::wykonać interfejsów.Najczęściej żądane właściwości są interfejsy, musi obsługiwać zestaw wierszy.Oprócz interfejsów konsument może poprosić o właściwości, które modyfikują zachowanie zestawu zestaw wierszy lub interfejs.

Konsumenci Zwolnij zestawów wierszy z IRowset::Release metoda.Zwalnianie zestawu zestaw wierszy zwalnia wszystkie uchwyty wiersza posiadanych przez konsumenta w tym zestawie zestaw wierszy.Zwalnianie zestawu zestaw wierszy nie zwalnia Akcesory.Jeśli masz IAccessor interfejs, nadal musi zostać zwolnione.