WorkbookBase.LinkInfo(String, XlLinkInfo, Object, Object) Methode

Referenz

Definition

Namespace:: Microsoft.Office.Tools.Excel

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

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft das Linkdatum und den Aktualisierungsstatus ab.

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

Parameter

name: String

Der Name des Links.

linkInfoArgument: XlLinkInfo

Einer der XlLinkInfo-Werte, der den Typ der zurückzugebenden Informationen angibt.

type: Object

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

editionRef: Object

Wenn der Link eine Auflage ist, gibt dieser Parameter den Auflagenverweis als Zeichenfolge in der Z1S1-Schreibweise zurück. EditionRef ist erforderlich, wenn mehrere Herausgeber oder Abonnenten mit demselben Namen in der Arbeitsmappe vorhanden sind.

Gibt zurück

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.

Beispiele

Im folgenden Codebeispiel wird die Auflistung von DDE/OLE-Links in der aktuellen Arbeitsmappe abgerufen und anschließend mithilfe der LinkInfo -Methode ermittelt, ob jeder DDE/OLE-Link automatisch oder manuell aktualisiert wird.

Dieses Beispiel gilt für eine Anpassung auf Dokumentebene.

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

Hinweise

Optionale Parameter

Informationen zu optionalen Parametern finden Sie unter Optionale Parameter in Office-Projektmappen.

Gilt für:

Freigeben über