Método DataRecordset.Refresh (Visio)

Executa a cadeia de caracteres de consulta associada ao conjunto DataRecordset (não baseado em XML) e atualiza formas vinculadas com novos dados da fonte de dados retornados pela consulta.

Observação

This Visio object or member is available only to licensed users of Visio Professional 2013.

Sintaxe

expressão. Atualização

Expressão Uma expressão que retorna um objeto DataRecordset .

Valor de retorno

Nada

Comentários

Chamar o método Refresh em um objeto DataRecordset específico resulta em atualizar todos os outros objetos DataRecordset associados ao mesmo objeto DataConnection (ou seja, ter o mesmo valor para sua propriedade DataConnection ). Objetos DataRecordset que compartilham o mesmo valor de propriedade DataConnection são chamados de conjuntos de registros de dados transacionados . O método Refresh deve ser chamado em um conjunto de registros de dados associado a um objeto DataConnection .

Se você chamar Refresh em um conjunto de registros de dados não associado a um objeto DataConnection (criado usando o método DataRecordsets.AddFromXML), o método Refresh retornará um erro.

Se a chamada de Refresh resultar em conflitos, o Visio exibirá o painel de tarefas Conflitos de Atualização na interface do usuário, a menos que você defina para a propriedade DataRecordset.RefreshSettings incluir o valor enumerado visRefreshNoReconciliationUI.

Antes de atualizar dados vinculados, se você quiser alterar a cadeia de caracteres de consulta que o Visio usa para recuperar os dados para consultar uma tabela diferente no mesmo banco de dados, defina a propriedade DataRecordset.CommandString como um novo valor. Para se conectar a uma fonte de dados totalmente nova, defina os valores da propriedade DataRecordset.CommandString e DataConnection.ConnectionString .

Quando você atualiza dados e ocorre um conflito, você pode usar os métodos DataRecordset.GetAllRefreshConflicts e DataRecordset.GetMatchingRowsForRefreshConflict para determinar por que o conflito surgiu.

Exemplo

Essa macro do Microsoft Visual Basic for Applications (VBA) mostra como usar o método Refresh para atualizar os dados de um objeto DataRecordset da coleção DataRecordsets do documento atual. Ela obtém a contagem de todos os conjuntos de registros de dados associados ao documento atual e atualiza o conjunto de registros de dados adicionado mais recentemente. Ela também atualiza qualquer outro conjunto de registros de dados associado ao documento atual que compartilha uma conexão de dados comum com o conjunto de registros de dados que está sendo atualizado.

Antes de executar essa macro, verifique se o documento atual contém pelo menos um conjunto de registros de dados e se o conjunto de registros de dados adicionado mais recentemente está conectado (não baseado em 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

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.