Esempio di parametro matrice

Articolo
12/15/2008

Data aggiornamento: 14 aprile 2006

A volte può risultare utile creare, aggiornare o eliminare un set di righe in un database. Sono disponibili diversi modi per eseguire queste operazioni. Uno di questi consiste nel passare una matrice di informazioni da un client a una stored procedure basata sull'integrazione con CLR nel server mediante un tipo di dati per l'integrazione con CLR definito dall'utente. La natura di tale tipo di dati limita a 8.000 byte le dimensioni dei dati forniti al server. Questa opzione non è pertanto utile in caso di dati complessi o di grandi dimensioni. Per ulteriori informazioni, vedere la stored procedure per la creazione di informazioni di contatto nell'esempio Livello CLR di AdventureWorks Cycles. Se i dati disponibili sono semplici e di piccole dimensioni, questa opzione risulta più efficace rispetto alla chiamata di una stored procedure per ogni riga. Passando una matrice, l'ordine dei dati viene mantenuto per le applicazioni in cui tale ordine è importante.

Questo esempio include quanto segue:

Il tipo di dati definito dall'utente ContactTypeNames, che include l'elenco dei nomi dei tipi di contatti desiderati.
La stored procedure usp_EnsureContactTypeNames implementata come metodo Microsoft Visual C# o Microsoft Visual Basic che accetta un'istanza del tipo di dati definito dall'utente ContactTypeNames e inserisce nuove righe nella tabella Person.ContactType per i nomi di contatti inclusi nell'istanza del tipo di dati definito dall'utente e che non sono presenti nella tabella.
L'applicazione console TestArrayParameter che crea un'istanza del tipo di dati definito dall'utente ContactTypeNames sulla base dei parametri della riga di comando passati e quindi richiama la stored procedure usp_EnsureContactTypeNames passando l'istanza del tipo di dati definito dall'utente come parametro.

Directory di installazione: drive:\Programmi\Microsoft SQL Server\90\Samples\Engine\Programmability\CLR\ArrayParameter\.

Scenario

Jane è una sviluppatrice di Adventure Works Cycles e deve inserire una piccola quantità di righe semplici in una tabella riducendo al minimo il tempo di elaborazione del database.

Linguaggi

Transact-SQL, Visual C# e Visual Basic.

Funzionalità

L'esempio Array Parameter utilizza le funzionalità seguenti di Microsoft .

Area di applicazione	Funzionalità
Generale	CLR, tipo di dati definito dall'utente, Transact-SQL

Prerequisiti

Prima di eseguire questo esempio, verificare che siano installati i prodotti software seguenti:

Microsoft SQL Server 2005 o Microsoft SQL Server 2005 Express Edition (SQL Server Express). SQL Server Express è disponibile gratuitamente nel sito Web relativo a documentazione ed esempi di SQL Server 2005 Express Edition.
Il database AdventureWorks, incluso in SQL Server 2005 e disponibile nel sito Web per gli sviluppatori di SQL Server.
Gli esempi di Motore di database di SQL Server 2005, inclusi in SQL Server 2005. È possibile scaricare la versione più recente degli esempi dal sito Web per gli sviluppatori di SQL Server.
.NET Framework SDK 2.0 o Microsoft Visual Studio 2005. .NET Framework SDK è disponibile gratuitamente. Vedere Installazione di .NET Framework SDK.

Generazione dell'esempio

Se non è stato ancora creato un file di chiave con nome sicuro, generare il file di chiave seguendo le istruzioni seguenti.

Per generare un file di chiave con nome sicuro

Aprire il prompt dei comandi di Microsoft Visual Studio 2005. Fare clic sul pulsante Start, scegliere Tutti i programmi, Microsoft .NET Framework SDK 2.0, quindi SDK Command Prompt.

-- oppure --

Aprire il prompt dei comandi di Microsoft .NET Framework. Fare clic sul pulsante Start, scegliere Tutti i programmi, Microsoft .NET Framework SDK 2.0, quindi SDK Command Prompt.
Utilizzare il comando CD (change directory) per passare dalla directory corrente della finestra del prompt dei comandi alla cartella in cui sono stati installati gli esempi.

[!NOTA] Per determinare la cartella in cui si trovano gli esempi, fare clic sul pulsante Start, scegliere Tutti i programmi, Microsoft SQL Server 2005, Documentazione ed esercitazioni, quindi Samples. Se è stato utilizzato il percorso di installazione predefinito, gli esempi si troveranno in <unità_sistema>:\Programmi\Microsoft SQL Server\100\Samples.

Al prompt dei comandi digitare il comando seguente per generare il file di chiave:

sn -k SampleKey.snk

Importante:
Per ulteriori informazioni sulla coppia di chiavi con nome sicuro, vedere l'argomento relativo ai nomi sicuri e alla protezione in .NET Framework nel centro per sviluppatori di .NET su MSDN.

Per generare l'esempio Array Parameter

Compilare l'esempio tramite Visual Studio 2005 e la soluzione Visual Studio fornita oppure tramite Microsoft MSBuild, incluso in .NET Framework SDK 2.0. Eseguire comandi simili al seguente al prompt dei comandi .NET Framework:

msbuild /nologo /verbosity:quiet /property:Configuration=Debug CS\ArrayParameter.sln
Verificare che il database AdventureWorks sia installato.
Se gli esempi di Motore di database di SQL Server non sono stati installati nel percorso predefinito, modificare il percorso nella parte CREATE ASSEMBLY dello script in Scripts\InstallCS.sql per fare riferimento al percorso di installazione degli esempi.
Se non si è amministratore dell'istanza di SQL Server in uso, è necessario ottenere l'autorizzazione CreateAssembly dall'amministratore per completare l'installazione.
Aprire il file scripts\installCS.sql o scripts\installVB.sql, a seconda che sia stato compilato il progetto Visual C# o il progetto Visual Basic, in SQL Server Management Studio. Nella finestra del prompt dei comandi eseguire lo script incluso nel file o un comando simile al seguente:

sqlcmd -E -I -i Scripts\InstallCS.sql

Esecuzione dell'esempio

Per eseguire l'esempio Array Parameter

Al prompt dei comandi mediante il comando CD (Change Directory) passare dalla cartella corrente della finestra del prompt dei comandi alla directory dell'esempio ArrayParameter. Al prompt dei comandi eseguire il comando seguente:

Scripts\TestCS.cmd

Rimozione dell'esempio

Per rimuovere l'esempio Array Parameter

Aprire il file scripts\cleanup.sql in Management Studio. Eseguire lo script contenuto nel file oppure eseguire il comando seguente in una finestra del prompt dei comandi:

sqlcmd -E -I -i Scripts\cleanup.sql

Commenti

Per il corretto funzionamento di questo esempio, è necessario abilitare CLR per SQL Server 2005 o SQL Server Express.

Gli esempi vengono forniti esclusivamente a scopo didattico. Non sono destinati all'utilizzo in un ambiente di produzione e non sono stati testati in un ambiente di produzione. Microsoft non rende disponibile il supporto tecnico per questi esempi. Le applicazioni e gli assembly di esempio non devono essere connessi o utilizzati con il database di SQL Server o il server di report in un ambiente di produzione senza l'autorizzazione dell'amministratore di sistema.

Vedere anche

Attività

Livello CLR di AdventureWorks Cycles

Guida in linea e informazioni

Assistenza su SQL Server 2005

Cronologia modifiche

Versione	Cronologia
5 dicembre 2005	Contenuto modificato: Modifica delle istruzioni per la generazione di un file di chiave, inclusi il nome e il percorso del file di chiave.

Condividi tramite