WorkbookBase.LinkInfo-Methode

Artikel
05/07/2013

Ruft das Linkdatum und den Aktualisierungsstatus ab.

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel.v4.0.Utilities (in Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Syntax

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

Parameter

name
Typ: System.String
Der Name des Links.

linkInfoArgument
Typ: Microsoft.Office.Interop.Excel.XlLinkInfo
Einer der XlLinkInfo-Werte, der den Typ der zurückzugebenden Informationen angibt.

type
Typ: System.Object
Einer der XlLinkInfoType-Werte, der den Typ des Links angibt, für den Informationen zurückgegeben werden sollen.

editionRef
Typ: System.Object
Wenn der Link eine Auflage ist, gibt dieser Parameter den Auflagenverweis als Zeichenfolge in der Z1S1-Schreibweise zurück. EditionRef ist erforderlich, wenn mehr als ein Herausgeber oder Abonnent mit demselben Namen in der Arbeitsmappe vorhanden ist.

Rückgabewert

Typ: System.Object
Ein Wert, der Informationen zum Link angibt.Falls LinkInfoArgument gleich xlUpdateState ist, gibt diese Methode 1 zurück, wenn der Link automatisch aktualisiert wird, oder sie gibt 2 zurück, wenn der Link manuell aktualisiert werden muss.

Hinweise

Optionale Parameter

Informationen zu optionalen Parametern finden Sie unter Optionale Parameter in Office-Lösungen.

Beispiele

Im folgenden Codebeispiel wird die Auflistung der DDE/OLE-Links in der aktuellen Arbeitsmappe abgerufen, und dann wird mithilfe der LinkInfo-Methode bestimmt, ob die einzelnen DDE/OLE-Links automatisch oder manuell aktualisiert werden.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

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

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

WorkbookBase Klasse

Microsoft.Office.Tools.Excel-Namespace

Freigeben über