WorkbookBase.LinkInfo(String, XlLinkInfo, Object, Object) Método

Definición

Espacio de nombres:

Microsoft.Office.Tools.Excel

Ensamblado:

Microsoft.Office.Tools.Excel.v4.0.Utilities.dll

Obtiene la fecha del vínculo y el estado de actualización.

public object LinkInfo (string name, Microsoft.Office.Interop.Excel.XlLinkInfo linkInfoArgument, object type, object editionRef);

member this.LinkInfo : string * Microsoft.Office.Interop.Excel.XlLinkInfo * obj * obj -> obj

Public Function LinkInfo (name As String, linkInfoArgument As XlLinkInfo, Optional type As Object, Optional editionRef As Object) As Object

Parámetros

name

String

Nombre del vínculo.

linkInfoArgument

XlLinkInfo

Uno de los valores de XlLinkInfo que especifica el tipo de información que se devuelve.

type

Object

Uno de los valores XlLinkInfoType que especifica el tipo de vínculo del que se devuelve información.

editionRef

Object

Si el vínculo es una edición, este parámetro especifica la referencia de edición como una cadena en estilo R1C1. EditionRef es necesario si hay más de un publicador o suscriptor con el mismo nombre en el libro.

Devoluciones

Object

Valor que indica información sobre el vínculo. Si LinkInfoArgument es xlUpdateState, este método devuelve 1 si el vínculo se actualiza automáticamente o 2 si se debe actualizar manualmente.

Ejemplos

En el ejemplo de código siguiente se usa la colección de vínculos DDE/OLE en el libro actual y, a continuación, se usa el LinkInfo método para determinar si cada vínculo DDE/OLE se actualiza automáticamente o manualmente.

Este ejemplo es para una personalización de nivel de documento.

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.");
    }
}

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

Comentarios

Parámetros opcionales

Para obtener información sobre los parámetros opcionales, vea Parámetros opcionales en soluciones de Office.