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.

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.