Método DataRecordset.Refresh (Visio)

Executa a cadeia de consulta associada ao Conjunto de Dados (não baseado em XML) ligado e atualiza as formas ligadas com novos dados da origem de dados devolvida pela consulta.

Sintaxe

expressão. Atualização

expressão Uma expressão que devolve um objeto DataRecordset .

Valor de retorno

Nada

Comentários

Chamar o método Atualizar num determinado objeto DataRecordset resulta na atualização de todos os outros objetos DataRecordset associados ao mesmo objeto DataConnection (ou seja, ter o mesmo valor para a respetiva propriedade DataConnection ). Os objetos DataRecordset que partilham o mesmo valor de propriedade DataConnection são denominados conjuntos de registos de dados transacionados. O método Refresh tem de ser chamado num conjunto de registos 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 os dados ligados, se quiser alterar a cadeia de consulta que o Visio utiliza para obter os dados para consultar uma tabela diferente na mesma base de dados, defina a propriedade DataRecordset.CommandString para um novo valor. Para ligar a uma origem de dados totalmente nova, defina os valores da propriedade DataRecordset.CommandString e DataConnection.ConnectionString .

Quando atualiza dados e ocorre um conflito, pode utilizar os métodos DataRecordset.GetAllRefreshConflicts e DataRecordset.GetMatchingRowsForRefreshConflict para determinar por que motivo 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.