WorkbookBase.LinkInfo メソッド
リンクの日付と更新状況を取得します。
名前空間: 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 セキュリティ
- 直前の呼び出し元に対する完全な信頼。 このメンバーは、部分的に信頼されているコードから使用することはできません。 詳細については、「部分信頼コードからのライブラリの使用」を参照してください。