Propriedade WorkbookBase.Connections

Artigo
08/01/2011

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
    Get

public Connections Connections { get; }

Valor de propriedade

Tipo: Microsoft.Office.Interop.Excel.Connections
A Microsoft.Office.Interop.Excel.Connections coleção 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 itera em todas as conexões existentes na pasta de trabalho e exibe o nome, tipo e descrição de cada conexão. Este 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 é iniciado o O Assistente de importação de texto; Siga as etapas do Assistente para criar a conexão de dados para o arquivo CSV.

Este exemplo é para uma personalização em 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áveis.

Consulte também

Referência

WorkbookBase Classe

Namespace Microsoft.Office.Tools.Excel

Compartilhar via