NamedRange.Item - свойство

Статья
08/11/2011

Получает объект 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 должно использоваться с указанными ниже параметрами.

Параметр	Описание
RowIndex	Номер индекса ячейки, к которой необходим доступ, в порядке слева направо. NamedRange.Item(1) возвращает верхнюю левую ячейку диапазона; NamedRange.Item(2) возвращает ячейку, находящуюся непосредственно справа от верхней левой ячейки.
ColumnIndex	Номер или строка, указывающие на номер столбца ячейки, к которой необходимо получить доступ, начиная с 1 или «A» для первой ячейки в диапазоне.

RowIndex

Номер индекса ячейки, к которой необходим доступ, в порядке слева направо. NamedRange.Item(1) возвращает верхнюю левую ячейку диапазона; NamedRange.Item(2) возвращает ячейку, находящуюся непосредственно справа от верхней левой ячейки.

ColumnIndex

Номер или строка, указывающие на номер столбца ячейки, к которой необходимо получить доступ, начиная с 1 или «A» для первой ячейки в диапазоне.

При попытке использования свойства 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 - пространство имен

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