WorkbookBase.LinkInfo - метод

Статья
08/11/2011

Получает дату ссылки и статус обновления.

Пространство имен: Microsoft.Office.Tools.Excel
Сборка: Microsoft.Office.Tools.Excel.v4.0.Utilities (в Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Синтаксис

'Декларация
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
)

Параметры

name
Тип: System.String
Имя ссылки.

linkInfoArgument
Тип: Microsoft.Office.Interop.Excel.XlLinkInfo
Одно из значений XlLinkInfo, указывающее тип возвращаемых сведений.

type
Тип: System.Object
Одно из значений XlLinkInfoType, указывающее тип ссылки, для которой возвращаются сведения.

editionRef
Тип: System.Object
Если ссылка является выпуском, данный параметр задает ссылку на выпуск в виде строки в стиле R1C1.EditionRef является обязательным, если в книге имеется несколько издателей или подписчиков с одним и тем же именем.

Возвращаемое значение

Тип: System.Object
Значение, указывающие сведения о ссылке.Если параметр LinkInfoArgument имеет значение xlUpdateState, этот метод возвращает «1», если обновление ссылки выполняется автоматически или «2», если ссылку требуется обновлять вручную.

Заметки

Необязательные параметры

Сведения о необязательных параметрах см. в разделе Необязательные параметры в решениях Office.

Примеры

В следующем примере кода иллюстрируется получение коллекции ссылок DDE/OLE в текущей книге, затем вызывается метод LinkInfo для определения выполнения для ссылок DDE/OLE автоматического или ручного обновления, также определяется, какие именно ссылки обновляются.

В этом примере демонстрируется настройка уровня документа.

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

Безопасность платформы .NET Framework

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.

См. также

Ссылки

WorkbookBase Класс

Microsoft.Office.Tools.Excel - пространство имен

Поделиться через