File Leggimi relativo all'esempio UDT Utilities
Questo esempio funziona solo con SQL Server 2005 e SQL Server 2008. Non funzionerà con le versioni di SQL Server precedenti a SQL Server 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 con valori di tabella, API reflection di .NET Framework e il richiamo di funzioni con valori 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 deve essere la prima directory Framework nella variabile di ambiente PATH. Il percorso del compilatore incluso in SQL Server è unità:\WINNT\Microsoft.NET\Framework\v2.0.xxxxx o unità:\Windows\Microsoft.NET\Framework\v2.0.xxxxx, dove unità è l'unità di installazione e xxxxx è la versione di .NET Framework inclusa in SQL Server.
La directory di installazione predefinita è C:\Programmi\Microsoft SQL Server\100\Samples\Engine\Programmability\CLR\UDTUtilities.
Per visualizzare o utilizzare gli esempi e i database di esempio di SQL Server, è necessario prima scaricarli e installarli. Per ulteriori informazioni, vedere Considerazioni per l'installazione di esempi e di database di esempio di SQL Server.
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:
| Area di applicazione | Funzionalità |
|---|---|
Generale |
CLR |
Prerequisiti
Prima di eseguire l'esempio, verificare che siano installati i prodotti software seguenti:
- SQL Server o SQL Server Express. SQL Server Express è disponibile gratuitamente nel sito Web relativo a documentazione ed esempi di SQL Server Express.
- Il database AdventureWorks disponibile nel sito Web per gli sviluppatori di SQL Server.
- Gli esempi del Motore di database di SQL Server disponibili nel sito Web per gli sviluppatori di SQL Server.
- .NET Framework SDK 2.0 o Microsoft Visual Studio 2005. È possibile ottenere .NET Framework SDK gratuitamente. Vedere Installazione della documentazione di .NET Framework.
Generazione dell'esempio
Se non è ancora stato 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 e quindi fare clic su Prompt dei comandi di SDK.
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 e quindi fare clic su Prompt dei comandi di SDK.
Utilizzare il comando CD per modificare la directory corrente della finestra del prompt dei comandi nella cartella in cui sono 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, Documentazione ed esercitazioni e quindi fare clic su Directory esempi. 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 eseguire il comando seguente per generare il file di chiave:
sn -k SampleKey.snkImportante
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 questo esempio, procedere come segue:
Generazione dell'esempio
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.slnVerificare che il database AdventureWorks sia installato, o, se necessario, creare il database in cui si desidera installare gli esempi.
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.sqlQuesto 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
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.sqlLo 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
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.sqlQuesto script rimuove l'esempio.
Commenti
Per il corretto funzionamento di questo esempio, è necessario abilitare CLR per SQL Server o SQL Server Express.
Gli esempi vengono offerti esclusivamente a scopo didattico. Non sono progettati per l'utilizzo in un ambiente di produzione e non sono stati testati in un ambiente di produzione. Microsoftnon offre servizi di 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.