Excel2 Custom Connection Manager (ejemplo)

  • Artículo

Nuevo: 14 de abril de 2006

El ejemplo Excel2 Custom Connection Manager muestra cómo crear un administrador de conexión personalizado (el administrador de conexión Excel2) y su interfaz de usuario asociada. Este ejemplo no es compatible con los sistemas operativos basados en Itanium.

Para obtener más información acerca de la creación de un administrador de conexión personalizado, vea Creating a Custom Connection Manager. Para obtener información acerca del uso de los administradores de conexión en Integration Services, vea Conexiones de Integration Services y Administradores de conexión.

El administrador de conexión personalizado se conecta a un libro de Microsoft Excel disponible con el proveedor de datos de .NET Framework OleDb y el proveedor Microsoft OLE DB para Jet; se devuelve un objeto OleDbConnection abierto a partir de su método AcquireConnection. Cuando crea una nueva instancia del administrador de conexión Excel2 Connection Manager en un paquete, su interfaz de usuario personalizada le pide la ruta de acceso al libro de Excel. Este administrador de conexión también proporciona una casilla de verificación para especificar el modo de importación. Así se resuelve un problema que se produce con frecuencia cuando una columna de Excel contiene datos de texto y datos numéricos mezclados.

[!NOTA] El ejemplo Excel2 Custom Connection Manager no se puede utilizar con el origen y el destino de Excel. En su lugar, pruébelo con el origen y el destino de DataReader.

Este ejemplo de código implementa la siguiente funcionalidad:

ms365193.note(es-es,SQL.90).gifImportante:
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.

Ejecutar el ejemplo

Si ya sabe cómo ubicar, generar e instalar ejemplos de código, puede pasar directamente a la sección Probar el ejemplo y leer acerca de la configuración y ejecución de este ejemplo.

Requisitos previos

Este ejemplo requiere que estén instalados los siguientes componentes.

  • Microsoft Visual Studio 2005
  • Microsoft SQL Server 2005 Integration Services

Ubicación

Si el ejemplo de código se ha instalado en la ubicación predeterminada, el ejemplo se encuentra en el siguiente directorio:

C:\Archivos de programa\Microsoft SQL Server\100\Ejemplos\Integration Services\\Programming Samples\Control Flow\Excel2ConnectionManager Sample

La solución C# del ejemplo de código se encuentra en el directorio Excel2ConnMgrCS, mientras que la solución Visual Basic se encuentra en el directorio Excel2ConnMgrVB.

Para obtener información acerca del proceso de dos pasos necesario para instalar los ejemplos, vea Instalar ejemplos. Para obtener la última versión de los ejemplos, incluidos aquéllos comercializados tras la versión comercial original de SQL Server 2005, vea el artículo acerca de ejemplos y bases de datos de ejemplo de SQL Server 2005 publicado en abril de 2006.

Generar el ejemplo

Si aún no ha generado un archivo de clave de nombre seguro en la carpeta Samples, siga este procedimiento para generarlo. Los proyectos de ejemplo se configuran en la ficha Firma del cuadro de diálogo Propiedades del proyecto para firmar los ensamblados en tiempo de generación con este archivo de clave.

Para generar un archivo de clave de nombre seguro

  1. Para abrir 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, después, haga clic en Símbolo del sistema de Visual Studio 2005.

    O bien

    Para abrir un símbolo del sistema de Microsoft .NET Framework, haga clic en Inicio, seleccione Todos los programas, seleccione Microsoft .NET Framework SDK v2.0 y haga clic en Símbolo del sistema de SDK.

  2. En el símbolo del sistema, utilice el comando de cambio de directorio (CD) para cambiar la carpeta actual de la ventana del símbolo del sistema a la carpeta Samples. El archivo de clave que cree en esta carpeta se usará en todos los ejemplos de código de SQL Server 2005.

    [!NOTA] Para determinar la carpeta donde se encuentran los ejemplos, haga clic en Inicio, seleccione Todos los programas, Microsoft SQL Server 2005, 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\90\Samples.

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

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

  4. Necesitará el símbolo (token) de clave pública del archivo de clave en un paso posterior. Para obtener el símbolo de clave pública, extraiga primero la clave pública del archivo de clave en un archivo nuevo ejecutando el comando siguiente en el símbolo del sistema:

    sn -p SampleKey.snk SampleKeyPublic.snk

    Ahora muestre el símbolo de clave pública del nuevo archivo ejecutando el comando siguiente en el símbolo del sistema:

    sn -t SampleKeyPublic.snk

    Copie el símbolo de clave pública al Portapapeles o guárdelo para usarlo posteriormente.

Para generar el ejemplo en Microsoft Visual Studio 2005

  1. En el menú Archivo | Abrir, haga clic en Proyecto y abra Excel2ConnMgrVB.sln o Excel2ConnMgrCS.sln.

  2. En el Explorador de soluciones, seleccione el proyecto Excel2ConnMgrVB o Excel2ConnMgrCS.

  3. Busque el atributo DtsConnection antes de la declaración de clase en el archivo Excel2ConnMgrCS.cs o el archivo Excel2ConnMgrVB.vb y reemplace el valor alfanumérico de símbolo (token) de clave pública en la propiedad UITypeName del atributo con el símbolo (token) de clave pública obtenido anteriormente en el archivo de clave.

  4. En el menú Generar, haga clic en Generar solución para generar la solución.

Instalar el ejemplo

Este ejemplo se proporciona en Visual Basic y C#. Para distinguir los ensamblados para cada versión del ejemplo, el nombre del ensamblado de salida lleva anexado CS o VB. Una vez que haya generado correctamente el componente, siga los pasos que se indican a continuación para agregarlo como administrador de conexión a un paquete en Business Intelligence Development Studio.

Para copiar el componente en la carpeta Connections

  1. Abra el Explorador de Windows o la aplicación que prefiera para trabajar en el sistema de archivos.

  2. Copie los ensamblados (Excel2ConnMgrCS.dll y Excel2ConnMgrUICS.dll, o Excel2ConnMgrVB.dll y Excel2ConnMgrUIVB.dll) en la carpeta Connections que se encuentra en %system%\Archivos de programa\Microsoft SQL Server\90\DTS\Connections.

Para instalar el componente en la caché de ensamblados global (GAC) arrastrando y colocando los ensamblados

  1. Abra el Explorador de Windows o la aplicación que prefiera para trabajar en el sistema de archivos.

  2. Arrastre los ensamblados desde la carpeta Connections hasta la carpeta en la que se encuentra la caché de ensamblados global (GAC), en %sistema%\assembly.

Para instalar el componente en la caché de ensamblados global (GAC) mediante gacutil.exe

  1. Abra una ventana del símbolo del sistema.

  2. Escriba los siguientes comandos para instalar la versión C# del componente y la interfaz de usuario en la GAC:

    gacutil.exe -iF "C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Programming Samples\Control Flow\Excel2ConnectionManager Sample\CS\Excel2ConnMgrCS\bin\Debug\Excel2ConnMgrCS.dll"
gacutil.exe -iF "C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Programming Samples\Control Flow\Excel2ConnectionManager Sample\CS\Excel2ConnMgrUICS\bin\Debug\Excel2ConnMgrUICS.dll"

    O bien

    Escriba los siguientes comandos para instalar la versión de Visual Basic del componente y la interfaz de usuario en la GAC:

    gacutil.exe -iF " C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Programming Samples\Control Flow\Excel2ConnectionManager Sample\VB\Excel2ConnMgrVB\bin\Debug\Excel2ConnMgrVB.dll"
gacutil.exe -iF " C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Programming Samples\Control Flow\Excel2ConnectionManager Sample\VB\Excel2ConnMgrVB\bin\Debug\Excel2ConnMgrUIVB.dll"

Probar el ejemplo

Ahora puede probar el administrador de conexión personalizado en un paquete.

Para usar el administrador de conexión de ejemplo en un paquete

  1. En el área de administradores de conexión del Diseñador SSIS, haga clic con el botón secundario, seleccione Nueva conexión y, en la lista de los tipos de conexión disponibles, seleccione EXCEL2. Haga clic en Aceptar.

  2. Modifique el administrador de conexión nuevo. En Excel2 Connection Manager Editor, busque un archivo de libro de Excel disponible. Utilice las casillas de verificación para especificar la configuración de los encabezados y del modo de importación.

    [!NOTA] El ejemplo Excel2 Custom Connection Manager no se puede utilizar con el origen de Excel, que sólo es compatible con el administrador de conexión de Excel integrado. En su lugar, pruébelo con el origen de DataReader.