Metodo WorkbookBase.LinkInfo

Articolo
08/11/2011

Ottiene la data di collegamento e lo stato di aggiornamento.

Spazio dei nomi: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel.v4.0.Utilities (in Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Sintassi

'Dichiarazione
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
)

Parametri

name
Tipo: System.String
Nome del collegamento.

linkInfoArgument
Tipo: Microsoft.Office.Interop.Excel.XlLinkInfo
Uno dei valori di XlLinkInfo che specifica il tipo di informazioni da restituire.

type
Tipo: System.Object
Uno dei valori di XlLinkInfoType che specifica il tipo di collegamento per il quale restituire informazioni.

editionRef
Tipo: System.Object
Se il collegamento è una versione, questo parametro specifica il riferimento alla versione sotto forma di stringa nella notazione R1C1.L'oggetto EditionRef è necessario se la cartella di lavoro contiene più di un editore o sottoscrittore con lo stesso nome.

Valore restituito

Tipo: System.Object
Valore che indica informazioni relative al collegamento.Se l'argomento LinkInfoArgument è impostato su xlUpdateState, questo metodo restituisce il valore 1 se il collegamento viene aggiornato automaticamente oppure il valore 2 se il collegamento viene aggiornato manualmente.

Note

Parametri facoltativi

Per informazioni sui parametri facoltativi, vedere Parametri facoltativi nelle soluzioni Office.

Esempi

Nell'esempio di codice seguente si ottiene l'insieme di collegamenti DDE/OLE presenti nella cartella di lavoro corrente. Viene quindi utilizzato il metodo LinkInfo per determinare se ogni collegamento DDE/OLE viene o meno aggiornato automaticamente oppure manualmente.

Questo esempio è valido per una personalizzazione a livello di 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,
                missing);

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

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Vedere anche

Riferimenti

WorkbookBase Classe

Spazio dei nomi Microsoft.Office.Tools.Excel

Condividi tramite