Funzioni di utilità per i tipi definiti dall'utente (UDT)

Data aggiornamento: 5 dicembre 2005

L'esempio UDTUtilities include una serie di funzioni di utilità quali funzioni per l'esposizione dei metadati dell'assembly a Transact-SQL, funzioni di flusso di esempio valutate a livello di tabella per la restituzione dei tipi di un assembly sotto forma di tabella e funzioni per la restituzione di campi, metodi e proprietà di un tipo di dati definito dall'utente. Le tecnologie illustrate comprendono funzioni di flusso valutate a livello di tabella, API Reflection di .NET Framework e il richiamo di funzioni valutate a livello di tabella da Transact-SQL.

Quando si compilano esempi di integrazione con CLR, il percorso della versione del compilatore Microsoft .NET Framework incluso in SQL Server 2005 deve essere la prima directory Framework nella variabile di ambiente PATH. Il percorso in cui è memorizzato il compilatore incluso in SQL Server 2005 è drive:\WINNT\Microsoft.NET\Framework\v2.0.xxxxx o drive:\Windows\Microsoft.NET\Framework\v2.0.xxxxx, dove drive è l'unità di installazione e xxxxx è la versione di .NET Framework inclusa in SQL Server 2005.

La directory di installazione predefinita è drive:\Programmi\Microsoft SQL Server\90\Samples\Engine\Programmability\CLR\UDTUtilities.

Scenario

Uno sviluppatore desidera accedere ai metadati relativi ai tipi CLR definiti dall'utente.

Linguaggi

Transact-SQL, Visual C# e Visual Basic.

Funzionalità

L'esempio UDTUtilities utilizza le funzionalità seguenti di SQL Server 2005:

Area di applicazione	Funzionalità
Generale	CLR

Prerequisiti

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

• SQL Server 2005 o 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 ancora non è stato creato il file di chiave con nome sicuro ExternalSampleKey.snk, generarlo seguendo le istruzioni riportate di seguito.

Per generare un file di chiave con nome sicuro

1. Aprire il prompt dei comandi Microsoft Visual Studio 2005. Fare clic sul pulsante Start, scegliere Tutti i programmi, Microsoft Visual Studio 2005, Visual Studio Tools e quindi Prompt dei comandi di Visual Studio 2005.

   —O—

   Aprire il prompt dei comandi Microsoft .NET Framework. Fare clic sul pulsante Start, scegliere Tutti i programmi, Microsoft .NET Framework SDK 2.0 e quindi Prompt dei comandi SDK.

2. Al prompt dei comandi mediante il comando CD (change directory) passare dalla directory corrente della finestra del prompt dei comandi alla cartella Samples.

   [!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 e quindi Directory esempi. Se è stato utilizzato il percorso di installazione predefinito, gli esempi si troveranno in <system_drive>:\Programmi\Microsoft SQL Server\90\Samples.

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

   sn -k ExternalSampleKey.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 (informazioni in lingua inglese).

Per generare questo esempio, procedere come segue:

Generazione dell'esempio

1. Compilare l'esempio tramite Visual Studio 2005 e la soluzione Visual Studio fornita oppure tramite Microsoft MSBuild, incluso in .NET Framework SDK 2.0. Al prompt dei comandi eseguire un comando simile al seguente:

   msbuild /nologo /verbosity:quiet /property:Configuration=Debug CS\UDTUtilities.sln

2. Verificare che il database AdventureWorks sia installato, o, se necessario, creare il database in cui si desidera installare gli esempi.

3. 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. Eseguire lo script contenuto nel file oppure al prompt dei comandi eseguire un comando simile al seguente:

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

   Questo file include lo script per l'installazione e la registrazione delle utilità di esempio in SQL Server.

Esecuzione dell'esempio

Per eseguire questo esempio, procedere come segue:

Esecuzione dell'esempio

1. Aprire il file scripts\test.sql in Management Studio. Eseguire lo script contenuto nel file oppure al prompt dei comandi eseguire il comando seguente:

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

   Lo script richiama gli oggetti di esempio dell'utilità di esempio da Transact-SQL.

Rimozione dell'esempio

Per rimuovere questo esempio, procedere come segue:

Rimozione dell'esempio

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

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

   Questo script rimuove l'esempio.

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

Concetti

Esempi di programmabilità CLR

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.