Preparazione all'implementazione di un'estensione per l'elaborazione dati

Prima di implementare l'estensione per l'elaborazione dati di SQL Server Reporting Services, è necessario definire le interfacce da implementare. È possibile specificare implementazioni specifiche dell'estensione dell'intero set di interfacce oppure semplicemente concentrarsi sull'implementazione su un subset, ad esempio le IDataReader interfacce e IDbCommand in cui i client interagiscono principalmente con un set di risultati come oggetto DataReader e useranno l'estensione per l'elaborazione dati SSRS come ponte tra il set di risultati e l'origine dati.

È possibile implementare le estensioni per l'elaborazione dati in uno dei due modi seguenti:

• Le classi di estensioni per l'elaborazione dati possono implementare le interfacce del provider di dati microsoft .NET Framework e facoltativamente le interfacce di estensione per l'elaborazione dati estese fornite da Reporting Services.

• Le classi di estensioni per l'elaborazione dati possono implementare le interfacce di estensione per l'elaborazione dati fornite da Reporting Services e facoltativamente le interfacce di estensione per l'elaborazione dati estese.

Se l'estensione per l'elaborazione dati di Reporting Services non supporterà una determinata proprietà o metodo, implementare la proprietà o il metodo come nessuna operazione. Se un client prevede un comportamento specifico, genera un'eccezione NotSupportedException .

Annotazioni

Un'implementazione senza operazioni di una proprietà o di un metodo si applica solo alle proprietà e ai metodi di tali interfacce che si sceglie di implementare. Le interfacce facoltative che si sceglie di non implementare devono essere interrotte dall'assembly dell'estensione per l'elaborazione dati. Per altre informazioni sul fatto che un'interfaccia sia obbligatoria o facoltativa, vedere la tabella più avanti in questa sezione.

Funzionalità di estensione necessarie

Ogni estensione per l'elaborazione dati di Reporting Services deve fornire le funzionalità seguenti:

• Aprire una connessione a un'origine dati.

• Analizzare una query e restituire un elenco di nomi di campo per il set di risultati.

• Eseguire una query sull'origine dati e restituire un set di righe.

• Passare parametri a valore singolo alla query.

• Scorrere le righe nel set di righe e recuperare i dati.

Ogni estensione per l'elaborazione dati può essere estesa per includere le funzionalità seguenti:

• Analizzare una query e restituire un elenco di nomi di parametri usati nella query.

• Analizzare una query e restituire l'elenco dei campi in base al quale la query è raggruppata.

• Analizzare una query e restituire l'elenco dei campi in base al quale viene ordinata la query.

• Specificare un nome utente e una password per connettersi all'origine dati indipendente dalla stringa di connessione.

• Scorrere le righe nel set di righe e recuperare i metadati ausiliari sui valori dei dati.

• Aggregare i dati nel server.

Interfacce di estensione disponibili

Nella tabella seguente vengono descritte le interfacce disponibili e se l'implementazione è obbligatoria o facoltativa.

Interfaccia	Descrizione	Implementazione
IDbConnection	Rappresenta una sessione univoca con un'origine dati. Nel caso di un sistema di database client/server, la sessione può essere equivalente a una connessione di rete al server.	Obbligatorio
IDbConnectionExtension	Rappresenta proprietà di connessione aggiuntive che possono essere implementate dalle estensioni per l'elaborazione dati SSRS relative alla sicurezza e all'autenticazione.	Opzionale
IDbTransaction	Rappresenta una transazione locale.	Obbligatorio
IDbTransactionExtension	Rappresenta proprietà aggiuntive delle transazioni che possono essere implementate dalle estensioni per l'elaborazione dati SSRS.	Opzionale
IDbCommand	Rappresenta una query o un comando utilizzato quando si è connessi a un'origine dati.	Obbligatorio
IDbCommandAnalysis	Rappresenta informazioni aggiuntive sui comandi per l'analisi di una query e la restituzione di un elenco di nomi di parametri utilizzati nella query.	Opzionale
IDataParameter	Rappresenta una coppia di parametri o nome/valore passata a un comando o a una query.	Obbligatorio
IDataParameterCollection	Rappresenta una raccolta di tutti i parametri rilevanti per un comando o una query.	Obbligatorio
IDataReader	Fornisce un metodo di lettura di un flusso di dati forward-only di sola lettura dall'origine dati.	Obbligatorio
IDataReaderExtension	Fornisce un metodo di lettura di uno o più flussi forward-only dei set di risultati, ottenuti eseguendo un comando in un'origine dati. Questa interfaccia offre supporto aggiuntivo per le aggregazioni di campi.	Opzionale
IExtension	Fornisce la classe di base per un'estensione per l'elaborazione dati di Reporting Services. Consente inoltre a un implementatore di includere un nome localizzato per l'estensione e di passare le impostazioni di configurazione dal file di configurazione all'estensione.	Obbligatorio

Le interfacce di estensione per l'elaborazione dati sono identiche a un subset delle interfacce, dei metodi e delle proprietà del provider di dati .NET Framework, quando possibile. Per altre informazioni sull'implementazione di un provider di dati .NET Framework completo, vedere "Implementazione di un provider di dati .NET Framework" nella documentazione di .NET Framework Software Development Kit (SDK).

Vedere anche

Estensioni di Reporting Services
Implementazione di un'estensione per l'elaborazione dati
Libreria di estensioni di Reporting Services