Implementazione di una classe DataReader per un'estensione per l'elaborazione datiImplementing a DataReader Class for a Data Processing Extension

Il DataReader oggetto consente a un client recuperare un flusso forward-only in sola lettura di dati da un'origine dati.The DataReader object enables a client to retrieve a read-only, forward-only stream of data from a data source. Vengono restituiti come la query viene eseguita e vengono archiviati nel buffer di rete nel client fino a quando non ne fanno richiesta utilizzando il lettura metodo il DataReader classe.Results are returned as the query executes and are stored in the network buffer on the client until you request them using the Read method of the DataReader class. Per creare un DataReader classe, implementare IDataReader e implementare facoltativamente IDataReaderExtension.To create a DataReader class, implement IDataReader and optionally implement IDataReaderExtension. Utilizzando un DataReader oggetto aumenta le prestazioni dell'applicazione recuperando i dati appena sono disponibile, anziché attendere che tutti i risultati della query restituita e (per impostazione predefinita) l'archiviazione solo una riga alla volta in memoria, riducendo l'overhead di sistema.Using a DataReader object increases application performance both by retrieving data as soon as it is available, rather than waiting for the entire results of the query to be returned, and (by default) storing only one row at a time in memory, reducing system overhead.

Dopo aver creato un'istanza del comando (classe), si crea un DataReader oggetto chiamando Command. ExecuteReader per recuperare le righe dall'origine dati.After creating an instance of your Command class, you create a DataReader object by calling Command.ExecuteReader to retrieve rows from the data source. Il DataReader implementazione deve fornire due funzionalità di base: accesso forward-only sul risultato del imposta ottenuto eseguendo un comando e l'accesso ai tipi di colonna, nomi e valori all'interno di ogni riga.The DataReader implementation must provide two basic capabilities: forward-only access over the result sets obtained by executing a command and access to the column types, names, and values within each row. I client utilizzano il lettura metodo il DataReader per ottenere una riga dai risultati della query.Clients use the Read method of the DataReader object to obtain a row from the results of the query.

In Progettazione Report, il DataReader oggetto viene utilizzato per recuperare un elenco di campi, nonché informazioni sullo schema relative a set di risultati.In Report Designer, your DataReader object is used to retrieve a list of fields as well as schema information about the result set. Questa operazione viene eseguita implementando il GetName, GetValue, GetFieldType, e GetOrdinal metodi il IDataReader interfaccia.This is accomplished by implementing the GetName, GetValue, GetFieldType, and GetOrdinal methods of the IDataReader interface.

L'interfaccia IDataReaderExtension consente di fornire informazioni di aggregazione specifiche per il set di risultati.The IDataReaderExtension interface allows you to supply specific aggregation information about your result set. Per un esempio DataReader implementazione della classe, vedere SQL Server Reporting Services Product Samples.For a sample DataReader class implementation, see SQL Server Reporting Services Product Samples.

Vedere ancheSee Also

Estensioni di Reporting Services Reporting Services Extensions
Implementazione di un'estensione di elaborazione dei dati Implementing a Data Processing Extension
Libreria di estensioni di Reporting ServicesReporting Services Extension Library