Método DataRecordset.Refresh (Visio)

Ejecuta la cadena de consulta asociada al conjunto de registros de datos conectado (no basado en XML) y actualiza las formas vinculadas con nuevos datos del origen de datos devuelto por la consulta.

Nota:

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

Sintaxis

expresión.Refresh

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

Valor devuelto

Nothing

Comentarios

Al llamar al método Refresh en un objeto DataRecordset determinado, se actualizan todos los demás objetos DataRecordset asociados al mismo objeto DataConnection (es decir, que tienen el mismo valor para su propiedad DataConnection ). Los objetos DataRecordset que comparten el mismo valor de propiedad DataConnection se denominan conjuntos de registros de datos con transacciones . Se debe llamar al método Refresh en un conjunto de registros de datos asociado a un objeto DataConnection .

Si se llama a Refresh para un conjunto de registros de datos que no está asociado a un objeto DataConnection (creado mediante el método DataRecordsets.AddFromXML), el método Refresh devuelve un error.

Si al llamar a Refresh se provoca algún conflicto, Visio muestra el panel de tareas Conflictos de actualización en la interfaz de usuario, a menos que se establezca la propiedad DataRecordset.RefreshSettings de modo que incluya el valor enumerado visRefreshNoReconciliationUI.

Antes de actualizar los datos vinculados, si desea cambiar la cadena de consulta que Usa Visio para recuperar los datos para consultar una tabla diferente en la misma base de datos, establezca la propiedad DataRecordset.CommandString en un nuevo valor. Para conectarse a un origen de datos completamente nuevo, establezca los valores de propiedad DataRecordset.CommandString y DataConnection.ConnectionString .

Al actualizar datos y se produce un conflicto, puede usar los métodos DataRecordset.GetAllRefreshConflicts y DataRecordset.GetMatchingRowsForRefreshConflict para determinar por qué se produjo el conflicto.

Ejemplo:

En esta macro de Microsoft Visual Basic para Aplicaciones (VBA) se muestra cómo usar el método Refresh para actualizar los datos de un objeto DataRecordset de la colección DataRecordsets del documento actual. Se obtiene el recuento de todos los conjuntos de registros de datos asociados al documento actual y se actualiza el que se haya agregado más recientemente. Además, se actualizan todos los demás conjuntos de registros de datos asociados al documento actual que compartan la misma conexión de datos con el que se va a actualizar.

Antes de ejecutar esta macro, asegúrese de que el documento actual contenga al menos un conjunto de registros de datos y de que el último conjunto de registros de datos agregado esté conectado (es decir, que no esté basado en XML).

Public Sub Refresh_Example() 
 
    Dim vsoDataRecordset As Visio.DataRecordset 
    Dim intCount As Integer 
 
    intCount = ThisDocument.DataRecordsets.Count 
    Set vsoDataRecordset = ThisDocument.DataRecordsets(intCount) 
    vsoDataRecordset.Refresh 
 
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.