Método WorkbookBase.SetLinkOnData

Artigo
01/09/2014

Define o nome de um procedimento que executa sempre que um link de 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 de link de DDE/OLE, como retornado pelo método de LinkSources .

procedure
Tipo: System.Object
O nome do procedimento para ser executado quando o link é atualizado.Isso pode ser o Microsoft Office Excel 4,0 macro ou um procedimento do Visual Basic.Defina esse argumento para uma cadeia de caracteres vazia ("") para indicar que nenhum procedimento deve executar quando o link é atualizado.

Comentários

Parâmetros Opcionais

Para obter informações sobre 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 links de DDE na pasta de trabalho atual e usa o método de SetLinkOnData para executar uma macro denominada UPDATE_MACRO sempre que um dos links é atualizado.

Este exemplo destina-se a uma personalização no 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ável.

Consulte também

Referência

WorkbookBase Classe

Namespace Microsoft.Office.Tools.Excel

Compartilhar via