Método DataRecordsets.AddFromConnectionFile (Visio)

Agrega un objeto DataRecordset a la colección DataRecordsets mediante la información de conexión y consulta contenida en un archivo de conexión de datos de Office (ODC) para conectarse y recuperar datos de un origen de datos OLEDB o ODBC.

Nota:

Este objeto o miembro Visio solo se encuentra disponible para los usuarios con licencia de Visio Professional 2013.

Sintaxis

expresión. AddFromConnectionFile (FileName, AddOptions, Name)

Expresión Expresión que devuelve un objeto DataRecordsets .

Parameters

Nombre	Obligatorio/opcional	Tipo de datos	Descripción
FileName	Necesario	String	Nombre del archivo de conexión ODC que se va a usar.
AddOptions	Necesario	Long	Opciones que determinan propiedades del conjunto de registros de datos que se va a agregar. Combinación de uno o varios valores enumerados de VisDataRecordsetAddOptions. Para obtener más información, vea la sección de comentarios.
Name	Opcional	Cadena	Asigna un nombre para mostrar al objeto DataRecordset que se va a agregar.

Valor devuelto

DataRecordset

Comentarios

Para el parámetro FileName, se pasa el nombre y la ruta completa de un archivo ODC que contiene una cadena de conexión que especifica la forma de establecer conexión con un origen de datos OLEDB u ODBC, y una cadena de consulta que especifica cómo se extraen los datos deseados del origen de datos.

Los archivos ODC usan HTML y XML para almacenar la información de consulta y conexión. El contenido del archivo se puede ver o editar en cualquier editor de texto. Los archivos ODC tienen la extensión del nombre de archivo .odc. Use el Asistente para conexión de datos en Microsoft Access o Microsoft Excel para crear un archivo ODC que se conectará a los datos que desee y recuperarlos.

El parámetro AddOptions puede ser una combinación de uno o más de los valores siguientes de la enumeración VisDataRecordsetAddOptions declarada en la biblioteca de tipos de Visio. El valor predeterminado es cero (0), que especifica que no se establece ninguna de las opciones.

Constante	Valor	Descripción
visDataRecordsetNoExternalDataUI	1	Impide que los datos del nuevo conjunto de registros de datos se muestren en la ventana Datos externos.
visDataRecordsetNoRefreshUI	2	Impide que el conjunto de registros de datos se incluya en la operación de actualización y se muestre en el cuadro de diálogo Actualizar datos.
visDataRecordsetNoAdvConfig	4	Impide que el conjunto de registros de datos se muestre en el cuadro de diálogo Configurar actualización.
visDataRecordsetDelayQuery	8	Agrega un conjunto de registros de datos, pero no ejecuta la consulta CommandString hasta la siguiente vez que se llama al método Refresh.
visDataRecordsetDontCopyLinks	16	Agrega un conjunto de registros de datos, pero los vínculos de datos de formas no se cortan ni copian.

Una vez asignados estos valores, no se pueden cambiar durante la existencia del objeto DataRecordset.

El argumento Name es una cadena opcional que permite asignar un nombre para mostrar al conjunto de registros de datos. Si se especifica que se muestre la ventana Datos externos en la UI de Visio, el nombre que se pase para este argumento aparecerá en la ficha de la ventana Datos externos correspondiente al conjunto de registros de datos agregado.

Si el método AddFromConnectionFile se realiza correctamente, realiza las siguientes acciones:

• Crea un objeto DataRecordset y le asigna el nombre especificado en el parámetro Name. Si no especifica un nombre, Visio asigna al conjunto de registros de datos el nombre de la tabla de base de datos que es el origen de los datos.

• Asocia un objeto DataConnection nuevo o existente al objeto DataRecordset.

• Ejecuta la cadena de consulta especificada en la cadena de comando dentro del archivo ODC y recupera los datos resultantes.

• Asigna los tipos de datos de las columnas del origen de datos a tipos de datos de Visio equivalentes, y filtra los resultados para quitar las columnas del origen de datos que no se pueden vincular a formas de Visio porque no tienen tipos de datos de Visio equivalentes.

• Asigna un identificador de fila a cada una de las filas del conjunto de registros de datos. Para obtener más información sobre los identificadores de fila, vea el tema de la propiedad DataRecordset.GetDataRowIDs .

Nota:

El método AddFromConnectionFile no se ejecuta correctamente y devuelve una excepción si encuentra errores de conexión de red, tiempos de espera de red o errores de permiso de base de datos.

Ejemplo:

La siguiente macro de Microsoft Visual Basic para Aplicaciones (VBA) muestra cómo puede usar el método AddFromConnectionString para conectar un dibujo de Visio para conectarse a los datos de la tabla Products de la base de datos Northwind que se proporciona con Microsoft Access. Antes de ejecutar este código de ejemplo, use el Asistente para conexiones de datos para crear un archivo ODC y reemplace el valor de la variable strFile por la ruta de acceso completa a y el nombre de archivo del archivo ODC que creó. Opcionalmente, proporcione un valor diferente para la variable strName .

Public Sub AddFromConnectionFile_Example() 
 
    Dim strFile As String 
    Dim strName As String 
    Dim vsoDataRecordset As Visio.DataRecordset 
 
    strFile = "C:\Users\username \Documents\My Data Sources\Northwind.mdb Products.odc" 
 
    strName = "Data from ODC" 
 
    Set vsoDataRecordset = ThisDocument.DataRecordsets.AddFromConnectionFile(strFile, 0, strName) 
 
End Sub

Soporte técnico y comentarios

¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.