Ejemplo de Readme_String Utilities

  • Artículo

Este ejemplo sólo funciona con SQL Server 2005 y SQL Server 2008. No funcionará con ninguna versión de SQL Server anterior a SQL Server 2005.

El ejemplo StringUtilities contiene una función con valores de tabla de transmisión por secuencias, escrita en Visual C# y Visual Basic, que divide una cadena delimitada por comas en una tabla con una columna. También contiene una función de agregado que convierte una columna de cadenas en una cadena delimitada por comas.

Los archivos de origen concat.cs y concat.vb contienen la implementación de la función de agregado. Los archivos de origen split.cs y split.vb contienen la implementación de la función con valores de tabla de transmisión por secuencias. Los archivos de origen RegularExpression.cs y RegularExpression.vb implementan una función escalar y una función con valores de tabla que permiten reemplazar y buscar expresiones regulares.

Para implementar una función con valores de tabla de transmisión por secuencias, cree un método que devuelva un objeto que implemente la interfaz IEnumerable. Este método de IEnumerable debe estar vinculado mediante un atributo a otro método que rellene las filas de la función con valores de tabla.

Nota

Al compilar ejemplos de integración de common language runtime (CLR), la ruta de acceso de la versión del compilador de Microsoft .NET Framework que se distribuyó con SQL Server debe ser el primer directorio Framework de la variable de entorno PATH. La ubicación del compilador que se incluye con SQL Server 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 SQL Server.

El directorio de instalación predeterminado es Programmability\CLR\StringUtilities C:\Archivos de programa\Microsoft SQL Server\100\Samples\Engine.

Para poder ver o trabajar con las bases de datos de ejemplo y los ejemplos de SQL Server, se deben descargar e instalar antes. Para obtener más información, vea Consideraciones para instalar ejemplos y bases de datos de ejemplo de SQL Server.

Escenario

Un desarrollador desea crear una función que devuelva una tabla de valores mediante la transmisión por secuencias de dichos valores al autor de la llamada.

Lenguajes

Transact-SQL, Visual C# y Visual Basic.

Características

El ejemplo StringUtilities usa las siguientes características de SQL Server.

Área de aplicación Características

Global

Common Language Runtime (CLR)

Requisitos previos

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

  • SQL Server o bien SQL Server Express. Puede obtener SQL Server Express de forma gratuita desde el sitio web de Documentación y ejemplos de SQL Server Express.
  • La base de datos AdventureWorks que está disponible en el sitio web SQL Server Developer (en inglés).
  • Los ejemplos de SQL Server Database Engine (Motor de base de datos de SQL Server) disponibles en el sitio web SQL Server Developer .
  • .NET Framework SDK 2.0 o Microsoft Visual Studio 2005. Puede obtener el SDK de .NET Framework de forma gratuita. Vea Instalar la documentación de .NET Framework.

Generar el ejemplo

Para generar el ejemplo, deberá hacer lo siguiente:

Si aún no ha creado un archivo de clave de nombre seguro, genere este archivo mediante las siguientes instrucciones.

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 .NET Framework SDK 2.0 y, a continuación, haga clic en Símbolo del sistema de SDK.

    -- O bien --

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

  2. Use el comando de cambio de directorio (CD) para cambiar el directorio actual de la ventana del símbolo del sistema a la carpeta en la que están instalados los ejemplos.

    Nota

    Para determinar la carpeta donde se encuentran los ejemplos, haga clic en el botón Inicio, seleccione Todos los programas, Microsoft SQL Server, Documentación y tutoriales y, a continuación, haga clic en el directorio Ejemplos. Si se usó la ubicación de instalación predeterminada, los ejemplos se encuentran en <unidadDelSistema>:\Archivos de programa\Microsoft SQL Server\100\Samples.

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

    sn -k SampleKey.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.

Generar el ejemplo

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

    msbuild /nologo /verbosity:quiet /property:Configuration=Debug CS\StringUtilities.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, en función de que haya compilado el proyecto de Visual C# o el proyecto de Visual Basic, en SQL Server Management Studio. Ejecute el script 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 el script para instalar y registrar los objetos CLR de ejemplo 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 y ejecute el script que contiene. O bien, ejecute el siguiente comando en el símbolo del sistema:

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

    Este script muestra formas típicas de usar el ejemplo.

Quitar el ejemplo

Para quitar el ejemplo, deberá hacer lo siguiente:

Eliminar el ejemplo

  1. Abra el archivo scripts\cleanup.sql en Management Studio y ejecute el script que contiene. O bien, ejecute el siguiente comando en el símbolo del sistema:

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

    Este script quita el ejemplo.

Comentarios

El CLR para SQL Server 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 2008