UDTUtilities (ejemplo)

Actualizado: 5 de diciembre de 2005

El ejemplo UDTUtilities contiene una serie de funciones de utilidades. Entre ellas se incluyen funciones para exponer metadatos de ensamblado en Transact-SQL, ejemplos de funciones con valores de tabla (TVF) de transmisión para devolver los tipos de datos de un ensamblado en forma de tabla, así como funciones para devolver los campos, los métodos y las propiedades en un tipo de datos definido por el usuario. Algunas de las tecnologías que se muestran son las funciones con valores de tabla de transmisión, API de reflexión de .NET Framework y la invocación de funciones con valores de tabla de Transact-SQL.

Al compilar ejemplos de integración de Common Language Runtime (CLR), tenga en cuenta que la ruta de acceso de la versión del compilador de Microsoft .NET Framework que se distribuyó con SQL Server 2005 debe ser el primer directorio Framework de la variable de entorno PATH. La ubicación del compilador que se incluye con SQL Server 2005 es unidad:\WINNT\Microsoft.NET\Framework\v2.0.xxxxx o unidad:\Windows\Microsoft.NET\Framework\v2.0.xxxxx, donde unidad es la unidad de instalación y xxxxx es la versión de .NET Framework que se incluye con la copia de SQL Server 2005.

El directorio de instalación predeterminado es unidad:\Archivos de programa\Microsoft SQL Server\90\Samples\Engine\Programmability\CLR\UDTUtilities

Escenario

Un programador desea obtener acceso a metadatos sobre tipos de datos definidos por el usuario basados en CLR.

Lenguajes

Transact-SQL, Visual C# y Visual Basic.

Características

El ejemplo UDTUtilities usa las siguientes características de SQL Server 2005:

Requisitos previos

Antes de ejecutar este ejemplo, asegúrese de que esté instalado el siguiente software:

• SQL Server 2005 o bien SQL Server 2005 Express Edition (SQL Server Express). Puede obtener SQL Server Express sin cargo desde el sitio Web.
• La base de datos AdventureWorks incluida en SQL Server 2005, que también está disponible en el sitio Web para programadores de SQL Server.
• Los ejemplos de SQL Server 2005 Database Engine (Motor de base de datos de SQL Server 2005). Estos ejemplos están incluidos en SQL Server 2005. Puede descargar la última versión de los ejemplos en el sitio Web para programadores de SQL Server.
• .NET Framework SDK 2.0 o Microsoft Visual Studio 2005. Puede obtener .NET Framework SDK sin cargo. Vea Instalar .NET Framework SDK.

Generar el ejemplo

Si todavía no ha creado el archivo de clave de nombre seguro ExternalSampleKey.snk, siga estas instrucciones para generarlo.

Para generar un archivo de clave de nombre seguro

1. Abra un símbolo del sistema de Microsoft Visual Studio 2005. Haga clic en Inicio, seleccione Todos los programas, Microsoft Visual Studio 2005, Visual Studio Tools y, a continuación, haga clic en Visual Studio 2005 Command Prompt.

   O bien

   Abra un símbolo del sistema de Microsoft .NET Framework. Haga clic en Inicio, seleccione Todos los programas, Microsoft .NET Framework SDK v2.0 y, a continuación, haga clic en SDK Command Prompt.

2. En el símbolo del sistema, use el comando de cambio de directorio (CD) para cambiar la carpeta actual de la ventana del símbolo del sistema a la carpeta Samples.

   [!NOTA] Para determinar la carpeta donde se encuentran los ejemplos, haga clic en Inicio, seleccione Todos los programas, Microsoft SQL Server 2005, Documentation and Tutorials y, a continuación, haga clic en Samples Directory. Si se usó la ubicación de instalación predeterminada, los ejemplos se encuentran en <system_drive>:\Archivos de programa\Microsoft SQL Server\90\Samples.

3. En el símbolo del sistema, ejecute el comando siguiente para generar el archivo de clave:

   sn -k ExternalSampleKey.snk

   Importante:
   Para obtener más información acerca del par de claves de nombre seguro, vea el apartado sobre informes de seguridad de nombres seguros y seguridad en .NET Framework en el centro de desarrollo de .NET de MSDN.

Para generar el ejemplo, deberá hacer lo siguiente:

Generar el ejemplo

1. Compile el ejemplo mediante Visual Studio 2005 y la solución Visual Studio proporcionada o mediante Microsoft MSBuild, que se incluye en el SDK 2.0 de .NET Framework. Ejecute un comando similar al siguiente en el símbolo del sistema:

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

2. Asegúrese de que la base de datos AdventureWorks esté instalada o, si es necesario, cree la base de datos en la que desee instalar los ejemplos.

3. Abra el archivo scripts\installCS.sql o scripts\installVB.sql, según si ha compilado el proyecto Visual C# o el proyecto Visual Basic en SQL Server Management Studio. Ejecute la secuencia de comandos que contiene el archivo o ejecute un comando similar al siguiente en el símbolo del sistema:

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

   Este archivo contiene una secuencia de comandos para instalar y registrar los ejemplos de utilidades en SQL Server.

Ejecutar el ejemplo

Para ejecutar el ejemplo, deberá hacer lo siguiente:

Ejecutar el ejemplo

1. Abra el archivo scripts\test.sql en Management Studio. Ejecute la secuencia de comandos que contiene el archivo o ejecute el comando siguiente en el símbolo del sistema:

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

   Esta secuencia de comandos invoca los objetos de ejemplo de utilidad de Transact-SQL.

Eliminar el ejemplo

Para eliminar el ejemplo, deberá hacer lo siguiente:

Eliminar el ejemplo

1. Abra el archivo scripts\cleanup.sql en Management Studio. Ejecute la secuencia de comandos que contiene el archivo o ejecute el comando siguiente en el símbolo del sistema:

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

   Esta secuencia de comandos elimina el ejemplo.

Comentarios

El CLR para SQL Server 2005 o SQL Server Express debe estar habilitado para que este ejemplo funcione correctamente.

Los ejemplos se proporcionan exclusivamente con fines formativos. No se han diseñado para utilizarse en un entorno de producción y no se han probado en ningún entorno de este tipo. Microsoft no ofrece soporte técnico para estos ejemplos. Las aplicaciones y los ensamblados de ejemplo no se deben conectar ni usar con la base de datos de SQL Server de producción ni con el servidor de informes sin el permiso del administrador del sistema.

Vea también

Conceptos

Ejemplos de programación de CLR

Ayuda e información

Obtener ayuda sobre SQL Server 2005

Historial de cambios