Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Un conjunto de filas es un conjunto de filas que contienen columnas de datos. Los conjuntos de filas son objetos centrales que permiten que todos los proveedores de datos OLE DB expongan los datos del conjunto de resultados en formato tabular.
Después de que un consumidor cree una sesión mediante el método IDBCreateSession::CreateSession , el consumidor puede usar la interfaz IOpenRowset o IDBCreateCommand en la sesión para crear un conjunto de filas. El proveedor OLE DB de SQL Server Native Client admite ambas interfaces. Ambos métodos se describen aquí.
Cree un conjunto de filas llamando al método IOpenRowset::OpenRowset .
Esto equivale a crear un conjunto de filas en una sola tabla. Este método abre y devuelve un conjunto de filas que incluye todas las filas de una sola tabla base. Uno de los argumentos de OpenRowset es un identificador de tabla que identifica la tabla desde la que se va a crear el conjunto de filas.
Cree un objeto de comando llamando al método IDBCreateCommand::CreateCommand .
El objeto de comando ejecuta comandos que admite el proveedor. Con el proveedor OLE DB de SQL Server Native Client, el consumidor puede especificar cualquier instrucción Transact-SQL, como una instrucción SELECT o una llamada a un procedimiento almacenado. Los pasos para crear un conjunto de filas mediante un objeto de comando son:
El consumidor llama al método IDBCreateCommand::CreateCommand en la sesión para obtener un objeto de comando que solicita la interfaz ICommandText en el objeto de comando. Esta interfaz ICommandText establece y recupera el texto real del comando. El consumidor rellena el comando de texto llamando al método ICommandText::SetCommandText .
El usuario llama al método ICommand::Execute en el comando . El objeto de conjunto de filas creado cuando se ejecuta el comando contiene el conjunto de resultados del comando .
El consumidor puede usar la interfaz ICommandProperties para obtener o establecer las propiedades del conjunto de filas devuelto por el comando ejecutado por las interfaces ICommand::Execute . Las propiedades solicitadas con más frecuencia son las interfaces que debe admitir el conjunto de filas. Además de las interfaces, el consumidor puede solicitar propiedades que modifiquen el comportamiento del conjunto de filas o la interfaz.
Los consumidores liberan conjuntos de filas con el método IRowset::Release . Al liberar un conjunto de filas, se liberan los identificadores de fila que mantiene el consumidor en ese conjunto de filas. Liberar un conjunto de filas no libera los descriptores de acceso. Si tiene una interfaz IAccessor , todavía tiene que publicarse.