Manipulación de cadenas que detectan caracteres complementarios

  • Artículo

Actualizado: 5 de diciembre de 2005

El ejemplo StringManipulate para Microsoft SQL Server 2005 muestra el procesamiento de cadenas de caracteres complementarios. Este ejemplo muestra la implementación de cinco funciones de cadenas Transact-SQL que proporcionan las mismas funciones de manipulación de cadenas que las integradas, pero con una función adicional para caracteres complementarios para controlar cadenas de caracteres Unicode y complementarios. Las cinco funciones son len_s(), left_s(), right_s(), sub_s() y replace_s(), que equivalen a las funciones de cadenas integradas LEN(), LEFT(), RIGHT(), SUBSTRING() y REPLACE().

Ubicación predeterminada: unidad:\Archivos de programa\Microsoft SQL Server\90\Samples\Engine\Programmability\CLR\StringManipulate

Escenario

Un programador desea manipular con precisión las cadenas Unicode que contengan caracteres complementarios.

Lenguajes

Transact-SQL, Visual C# y Visual Basic.

Características

El ejemplo StringManipulate utiliza las siguientes características de Microsoft SQL Server.

Área de la aplicación Características

Global

Función definida por el usuario de CLR

Requisitos previos

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

  • Microsoft SQL Server 2005 o Microsoft 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.
  • Para que aparezcan los caracteres correctos en la ventana de resultados de SQL Server Management Studio, debe instalarse en el equipo la fuente Ext-B. Para cambiar la fuente en la ventana de resultados de Management Studio, en el menú Herramientas, haga clic en Opciones, expanda Entorno y, a continuación, haga clic en Fuentes y colores. Establezca la fuente en MingLiU_ExtB para Resultados del texto y/o Resultados de la cuadrícula. Debe cerrar y, a continuación, volver a abrir Management Studio para que los cambios surtan efecto.

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

    ms160903.note(es-es,SQL.90).gifImportante:
    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, haga lo siguiente:

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\ StringManipulate.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 desea instalar los ejemplos.

  3. Si no ha instalado los ejemplos de SQL Server Database Engine (Motor de base de datos de SQL Server) en la ubicación predeterminada, modifique la ruta de acceso de la parte CREATE ASSEMBLY de la secuencia de comandos que se encuentra en Scripts\InstallCS.sql y Scripts\InstallVB.sql para que haga referencia a la ubicación en la que se han instalado los ejemplos.

  4. Abra el archivo scripts\installCS.sql o scripts\installVB.sql, dependiendo de si ha compilado el proyecto de Visual C# o el proyecto de Visual Basic, en 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 objetos CRL de ejemplo en SQL Server.

Ejecutar el ejemplo

Para ejecutar el ejemplo, haga lo siguiente:

Ejecutar el ejemplo

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

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

    Esta secuencia de comandos invoca el ejemplo de manipulación de cadenas desde Transact-SQL.

Quitar el ejemplo

Para quitar el ejemplo StringManipulate, haga lo siguiente:

Quitar el ejemplo

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

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

    Esta secuencia de comandos quita el ejemplo.

Comentarios

El lenguaje 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.

Historial de cambios

Versión Historial

5 de diciembre de 2005
Contenido modificado:
  • Se cambiaron las instrucciones para generar un archivo de clave, incluidos el nombre y la ubicación del archivo.