Método WorkbookBase.SetLinkOnData

Artigo
08/01/2011

Define o nome de um procedimento executado sempre que um vínculo DDE é atualizado.

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 Sub SetLinkOnData ( _
    name As String, _
    procedure As Object _
)

public void SetLinkOnData(
    string name,
    Object procedure
)

Parâmetros

name
Tipo: System.String
O nome do vínculo DDE/OLE, como retornado pelo LinkSources método.

procedure
Tipo: System.Object
O nome do procedimento a ser executado quando o vínculo é atualizado.Isso pode ser uma macro do Excel 4.0 da Microsoft Office ou um procedimento de Visual Basic.Defina este argumento como uma seqüência vazia ("") para indicar que nenhum procedimento seja executado quando o vínculo é atualizado.

Comentários

Optional Parameters

Para obter informações sobre os parâmetros opcionais, consulte Parâmetros opcionais em soluções do Office.

Exemplos

O exemplo de código a seguir obtém a coleção de todos os vínculos DDE da pasta de trabalho atual e usa o SetLinkOnData método para executar uma macro denominada UPDATE_MACRO sempre que um dos links é atualizado.

Este exemplo é para uma personalização em nível de documento.

Private Sub WorkbookSetLinkOnData()
    Dim Links As Array = _
        CType(Me.LinkSources(Excel.XlLink.xlOLELinks),  _
        Array)
    If Links IsNot Nothing Then
        Dim i As Integer
        For i = 1 To Links.Length
            Me.SetLinkOnData(Links(i), "UPDATE_MACR0")
        Next i
    Else
        MsgBox("The workbook contains no DDE/OLE links.")
    End If
End Sub

private void WorkbookSetLinkOnData()
{
    Array links = (Array)this.LinkSources(Excel.XlLink.xlOLELinks);

    if (links != null)
    {
        for (int i = 1; i <= links.Length; i++)
        {
            this.SetLinkOnData((string)links.GetValue(i), "UPDATE_MACR0");
        }
    }
    else
    {
        MessageBox.Show("The workbook contains no DDE/OLE links.");
    }
}

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