NamedRange.Item Свойство (2007 System)

Статья
11/16/2008

Обновлен: Июль 2008

Получает объект Microsoft.Office.Interop.Excel.Range, представляющий диапазон со смещением для элемента управления NamedRange.

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

Синтаксис

'Декларация
<BrowsableAttribute(False)> _
Public ReadOnly Property Item As NamedRange..::._ItemType
'Применение
Dim instance As NamedRange
Dim value As NamedRange..::._ItemType

value = instance.Item

[BrowsableAttribute(false)]
public 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 Tools for Office и не предназначен для использования непосредственно из кода.

Аргументы 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 vstoWorksheet As Worksheet = CType( _
        Me.Application.ActiveWorkbook.Worksheets(1),  _
        Excel.Worksheet).GetVstoObject()
    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 = ((Excel.Worksheet)
        this.Application.ActiveWorkbook.Worksheets[1]).GetVstoObject();
    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();
}

Разрешения

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

См. также

Ссылки

NamedRange Класс

NamedRange - члены

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

Журнал изменений

Дата	Журнал событий	Причина
Июль 2008	Добавлена версия кода для надстройки уровня приложения.	Изменение функции SP1.

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