Método PivotCache.MakeConnection (Excel)

Estabelece uma conexão para o cache de tabela dinâmica especificado.

Sintaxe

expressão. MakeConnection

Expressão Uma variável que representa um objeto PivotCache .

Comentários

O método MakeConnection pode ser usado depois que o cache libera uma conexão e o usuário deseja restabelecer a conexão.

Vários objetos e métodos podem retornar um erro em tempo de execução se o cache não for conectado. O uso desse método garante uma conexão antes da execução de outros objetos ou métodos.

Esse método resultará em um erro de tempo de execução se a propriedade MaintainConnection do cache de Tabela Dinâmica especificada tiver sido definida como False, a propriedade SourceType do cache de Tabela Dinâmica especificada não tiver sido definida como xlExternal ou se a conexão não for com uma fonte de dados OLE DB.

Observação

O Microsoft Excel pode liberar uma conexão temporariamente durante uma sessão (desconhecida do programador de VBA), por isso este método é útil.

Exemplo

O exemplo a seguir determina se o cache está conectado à sua fonte e cria uma conexão com a fonte, se necessário. O exemplo supõe que exista um relatório de tabela dinâmica na planilha ativa.

Sub UseMakeConnection() 
 
    Dim pvtCache As PivotCache 
 
    Set pvtCache = Application.ActiveWorkbook.PivotCaches.Item(1) 
 
    ' Handle run-time error if external source is not an OLE DB data source. 
    On Error GoTo Not_OLEDB 
 
    ' Check connection setting and make connection if necessary. 
    If pvtCache.IsConnected = True Then 
        MsgBox "The MakeConnection method is not needed." 
    Else 
        pvtCache.MakeConnection 
        MsgBox "A connection has been made." 
    End If 
    Exit Sub 
 
Not_OLEDB: 
    MsgBox "The data source is not an OLE DB data source" 
 
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.