Propriedade WorkbookBase.Connections

Artigo
01/09/2014

Obtém a coleção de conexões entre a pasta de trabalho e uma fonte de dados.

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel.v4.0.Utilities (em Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Sintaxe

'Declaração
Public ReadOnly Property Connections As Connections

public Connections Connections { get; }

Valor de propriedade

Tipo: Microsoft.Office.Interop.Excel.Connections
Uma coleção de Microsoft.Office.Interop.Excel.Connections que contém as conexões entre a pasta de trabalho e uma fonte de dados.

Exemplos

O exemplo de código a seguir adiciona uma nova conexão de dados para o arquivo CSV especificado. Em seguida, o exemplo efetua iterações através de todas as conexões que existem na pasta de trabalho e exibe o nome, tipo, e a descrição de cada conexão. Esse exemplo requer um arquivo CSV chamado SalesData.csv na raiz da unidade C. O arquivo CSV deve conter dados separados por vírgulas. Quando você executa esse exemplo, o excel começa Assistente de importação de texto; siga as etapas no assistente para criar a conexão de dados para o arquivo CSV.

Este exemplo destina-se a uma personalização no nível de documento.

Private Sub WorkbookConnections()
    Dim myConnection As Excel.WorkbookConnection = _
        Me.Connections.AddFromFile("c:\SalesData.csv")
    myConnection.Description = "Data stored in a CSV file."

    For Each connection As Excel.WorkbookConnection In Me.Connections
        MessageBox.Show(connection.Name + " " + connection.Type.ToString() _
            + " " + connection.Description)
    Next
End Sub

private void WorkbookConnections()
{
    Excel.WorkbookConnection myConnection =
        this.Connections.AddFromFile(@"C:\SalesData.csv");
    myConnection.Description = "Data stored in a CSV file.";

    foreach (Excel.WorkbookConnection connection in this.Connections)
    {
        MessageBox.Show(
            "Connection Name: " + connection.Name 
            + "\r\nConnection Type: " + connection.Type.ToString()
            + "\r\nDescription: " + connection.Description);
    }
}

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.

Consulte também

Referência

WorkbookBase Classe

Namespace Microsoft.Office.Tools.Excel

Compartilhar via