共用方式為

NamedRange.Item 屬性

  • 發行項

取得 Microsoft.Office.Interop.Excel.Range，表示 NamedRange 控制項的位移 (Offset) 範圍。

命名空間：  Microsoft.Office.Tools.Excel
組件：  Microsoft.Office.Tools.Excel (在 Microsoft.Office.Tools.Excel.dll 中)

語法

'宣告
ReadOnly Property Item As NamedRange_ItemType
    Get

NamedRange_ItemType Item { get; }

屬性值

型別：Microsoft.Office.Tools.Excel.NamedRange_ItemType
Microsoft.Office.Interop.Excel.Range ，表示 NamedRange 控制項的位移範圍。

備註

Item 屬性的用意是要與下列參數一起使用。

參數

描述

RowIndex

由左至右存取您想要的儲存格索引號碼。 NamedRange.Item(1) 會傳回範圍中的左上角儲存格，NamedRange.Item(2) 則會傳回緊接左上角儲存格右邊的儲存格。

ColumnIndex

一個數字或字串，指出您要存取之儲存格的欄編號，並以 1 或 "A" 做為該範圍內第 1 欄的起始值。

如果您嘗試在不指定任何參數的情況下使用 Item，則 Item 會得到 NamedRange_ItemType 物件，但該物件是 Visual Studio 基礎結構的一部分，並不適合直接在程式碼中使用。

RowIndex 和 ColumnIndex 引數為相對位移項目。 換句話說，將 RowIndex 指定為 1，會傳回該範圍內第一列儲存格的值，而非工作表的第一列。

範例

下列程式碼範例會建立 NamedRange，然後使用 Item 屬性選取從 NamedRange 偏移三個欄和三個列的儲存格。

這是示範文件層級自訂的版本。

Private itemRange As Microsoft.Office.Tools.Excel.NamedRange

Private Sub SelectItem()
    itemRange = Me.Controls.AddNamedRange( _
        Me.Range("A1"), "itemRange")
    itemRange.Value2 = "NamedRange"
    Dim offsetCell As Excel.Range = _
        CType(Me.itemRange.Item(3, 3), Excel.Range)
    offsetCell.Value2 = "Offset cell."
    offsetCell.Select()
End Sub

Microsoft.Office.Tools.Excel.NamedRange itemRange;
private void SelectItem()
{
    itemRange = this.Controls.AddNamedRange(
        this.Range["A1", missing], "itemRange");
    itemRange.Value2 = "NamedRange";
    Excel.Range offsetCell =
        (Excel.Range)this.itemRange.Item[3, 3];
    offsetCell.Value2 = "Offset cell.";
    offsetCell.Select();
}

這是示範應用程式層級增益集的版本。

Private itemRange As NamedRange

Private Sub SelectItem()

    Dim NativeWorksheet As Microsoft.Office.Interop.Excel.Worksheet =
        Globals.ThisAddIn.Application.ActiveSheet

    Dim vstoWorksheet As Microsoft.Office.Tools.Excel.Worksheet =
            Globals.Factory.GetVstoObject(NativeWorksheet)

    itemRange = vstoWorksheet.Controls.AddNamedRange( _
        vstoWorksheet.Range("A1"), "itemRange")
    itemRange.Value2 = "NamedRange"
    Dim offsetCell As Excel.Range = _
        CType(Me.itemRange.Item(3, 3), Excel.Range)
    offsetCell.Value2 = "Offset cell."
    offsetCell.Select()
End Sub

NamedRange itemRange;
private void SelectItem()
{
    Worksheet vstoWorksheet =
        Globals.Factory.GetVstoObject(this.Application.ActiveWorkbook.Worksheets[1]);
    itemRange = vstoWorksheet.Controls.AddNamedRange(
        vstoWorksheet.Range["A1", missing], "itemRange");
    itemRange.Value2 = "NamedRange";
    Excel.Range offsetCell =
        (Excel.Range)itemRange.Item[3, 3];
    offsetCell.Value2 = "Offset cell.";
    offsetCell.Select();
}

.NET Framework 安全性

請參閱

參考

NamedRange 介面

Microsoft.Office.Tools.Excel 命名空間