NamedRange.Item 属性

获取一个 Microsoft.Office.Interop.Excel.Range，它表示距离 NamedRange 控件的某偏移量处的范围。

命名空间：  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 属性旨在与下列参数一起使用。

如果尝试在不指定任何参数的情况下使用 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 命名空间