Compartir a través de

Objeto DataRecordset (Visio)

  • Artículo

Almacena, actualiza, expone y da formato a los datos consultados en una base de datos de Microsoft Visio.

Nota:

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

Comentarios

Microsoft Visio puede conectarse a los datos procedentes de diversos orígenes, incluidos los siguientes:

  • Hojas de cálculo de Excel
  • Bases de datos de Access
  • Bases de datos SQL Server
  • Listas de SharePoint
  • Otros orígenes de datos OLEDB/ODBC, como bases de datos de Oracle
  • Archivos XML que se adhieren al esquema XML clásico de ADO

Cada objeto Document de Visio tiene una colección DataRecordsets , que está vacía hasta que se realiza una conexión a un origen de datos. Para conectar un documento de Visio a un origen de datos, se agrega un objeto DataRecordset a la colección DataRecordsets del documento.

Para agregar un objeto DataRecordset a la colección DataRecordsets , puede usar uno de los tres métodos siguientes, en función del tipo de origen de datos al que quiera conectarse (OLEDB/ODBC o XML) y de cómo desee pasar cadenas de comandos de conexión y de consulta a Visio. Mediante el uso de:

  • Método DataRecordsets.Add , puede conectarse a un origen de datos OLEDB u ODBC y pasar información de cadena de comandos de conexión y consulta a Visio directamente como parámetros de método.

  • El método DataRecordsets.AddFromConnectionFile permite conectarse a un origen de datos OLEBD o ODBC pasando al método un archivo de conexión de datos de Office (ODC) que contiene la información de cadena de comandos de conexión y consulta que desea proporcionar a Visio.

  • El método DataRecordsets.AddFromXML pasa al método una cadena XML clásica de ADO que contiene todos los datos que desea incluir en el conjunto de registros de datos.

Después de crear un conjunto de registros de datos, las propiedades DataConnection.ConnectionString y CommandString representan la cadena de conexión y la cadena de comandos de consulta asociadas al conjunto de registros de datos, respectivamente.

Si el conjunto de registros de datos está asociado a un objeto DataConnection (es decir, si lo agregó a la colección DataRecordsets mediante el método Add o AddFromConnectionFile ), puede usar la propiedad DataConnection para obtener el objeto DataConnection asociado.

La propiedad predeterminada de un objeto DataRecordset es ID. El valor de la propiedad ID identifica el objeto DataRecordset en la colección DataRecordsets y es único en la colección correspondiente a cualquier documento concreto.

Use la propiedad Name para asociar un nombre para mostrar al conjunto de registros de datos.

Use el método GetDataRowIDs para obtener una matriz de los identificadores de todas las filas de un conjunto de registros de datos, donde cada fila representa un único registro de datos. Después de recuperar los identificadores de fila de datos de esta manera, puede usar el método GetRowData para obtener todos los datos almacenados en cada columna de la fila de datos.

Utilice la propiedad DataColumns para obtener el objeto DataColumn asociado al conjunto de registros de datos. El objeto DataColumn expone métodos y propiedades que se pueden usar para personalizar la asignación de las columnas de datos a las celdas de la sección Datos de formas de la hoja de cálculo ShapeSheet de Visio para las formas vinculadas a datos.

El establecimiento de una columna de clave principal para un conjunto de registros de datos puede ayudar a impedir que se rompan los vínculos entre las formas y los datos al actualizar estos últimos. Puede obtener y establecer la columna de clave principal mediante los métodos GetPrimaryKey y SetPrimaryKey respectivamente.

Cuando cambian los datos en el origen de datos, puede actualizar los datos de un conjunto de registros de datos conectado (que no sea XML) para reflejar dichos cambios. Puede especificar que Visio actualice los datos automáticamente a intervalos predefinidos mediante el establecimiento de la propiedad RefreshInterval o bien actualizar los datos mediante programación llamando al método Refresh.

Al actualizar los datos desde un origen de datos que ha cambiado desde la última vez que se actualizaron los datos, se pueden producir conflictos. Los conflictos pueden producirse cuando una sola forma está vinculada a más de una fila del mismo origen de datos o cuando una forma está vinculada a una fila del origen de datos que se ha eliminado. Para detectar y resolver los conflictos que surgen al actualizar los datos, use los métodos GetAllRefreshConflicts, GetMatchingRowsForRefreshConflicty RemoveRefreshConflict.

Nota:

Cuando se guarda un documento de Visio que contiene uno o varios conjuntos de registros de datos, todos los datos del conjunto de registros de datos se guardan en el archivo de Visio. Para aquellos conjuntos de registros de datos que contienen gran cantidad de datos, el archivo de Visio puede resultar demasiado grande, lo que puede afectar al rendimiento. Por este motivo, es conveniente filtrar los orígenes de datos de gran tamaño antes de importarlos a Visio.

Eventos

Métodos

Propiedades

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.