Método WorkbookBase.LinkInfo

Artigo
01/09/2014

Obtém o status de data e de atualização de link.

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 Function LinkInfo ( _
    name As String, _
    linkInfoArgument As XlLinkInfo, _
    type As Object, _
    editionRef As Object _
) As Object

public Object LinkInfo(
    string name,
    XlLinkInfo linkInfoArgument,
    Object type,
    Object editionRef
)

Parâmetros

name
Tipo: System.String
O nome do link.

linkInfoArgument
Tipo: Microsoft.Office.Interop.Excel.XlLinkInfo
Um dos valores de XlLinkInfo que especifica o tipo de informações para retornar.

type
Tipo: System.Object
Um dos valores de XlLinkInfoType que especifica o tipo de link para retornar informações para.

editionRef
Tipo: System.Object
Se o link é uma edição, este parâmetro especifica a referência de edição como uma cadeia de caracteres no estilo R1C1.EditionRef é necessário se houver mais de um editor ou assinante com o mesmo nome na pasta de trabalho.

Valor de retorno

Tipo: System.Object
Um valor que indica informações sobre o link.Se LinkInfoArgument é xlUpdateState, retorna 1 desse método se as atualizações de link automaticamente, ou os 2 se o link deve ser atualizado manualmente.

Comentários

Parâmetros Opcionais

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

Exemplos

Os seguintes usa o exemplo de código a seguir obtém a coleção de links de DDE/OLE na pasta de trabalho atual, e usam o método de LinkInfo para determinar se cada link de DDE/OLE automaticamente atualiza ou manualmente.

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

Private Sub WorkbookLinkInfo()
    ' Get the collection of DDE/OLE links in the workbook.
    Dim Links As Array = _
        CType(Me.LinkSources(Excel.XlLink.xlOLELinks),  _
        Array)

    ' If there are DDE/OLE links, then display how each link
    ' updates.
    If Links IsNot Nothing Then
        Dim i As Integer
        For i = 1 To Links.Length
            Dim UpdateValue As Integer = Me.LinkInfo(Links(i), _
                Excel.XlLinkInfo.xlUpdateState, _
                Excel.XlLinkInfoType.xlLinkInfoOLELinks)

            If UpdateValue = 1 Then
                MsgBox(Links(i) & " link updates automatically.")
            ElseIf UpdateValue = 2 Then
                MsgBox(Links(i) & " link updates manually.")
            End If
        Next i
    Else
        MsgBox("The workbook contains no DDE/OLE links.")
    End If
End Sub

private void WorkbookLinkInfo()
{
    // Get the collection of DDE/OLE links in the workbook.
    Array links = (Array)this.LinkSources(Excel.XlLink.xlOLELinks);

    // If there are DDE/OLE links, then display how each link
    // updates.
    if (links != null)
    {
        for (int i = 1; i <= links.Length; i++)
        {
            string linkName = (string)links.GetValue(i);
            int updateValue = (int)this.LinkInfo(linkName,
                Excel.XlLinkInfo.xlUpdateState,
                Excel.XlLinkInfoType.xlLinkInfoOLELinks);

            if (updateValue == 1)
            {
                MessageBox.Show(linkName + " link updates automatically.");
            }
            else if (updateValue == 2)
            {
                MessageBox.Show(linkName + " link updates manually.");
            }
        }
    }
    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