Worksheet.Range Свойство (2007 System)

Статья
11/16/2008

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

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

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

Синтаксис

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

value = instance.Range

[BrowsableAttribute(false)]
public virtual Worksheet..::._RangeType Range { get; }

Значение свойства

Тип: Microsoft.Office.Tools.Excel.Worksheet._RangeType
Объект Microsoft.Office.Interop.Excel.Range, представляющий ячейку или диапазон ячеек.

Заметки

Свойство Range должно использоваться с указанными ниже параметрами.

Параметр	Описание
Cell1	Имя диапазона в нотации стиля A1 на языке приложения. Оно может включать оператор диапазона (двоеточие), оператор пересечения (пробел) или оператор объединения (запятая). Оно также может включать знаки доллара, однако они игнорируются. Локально определенное имя можно использовать в любой части диапазона. При использовании имени предполагается, что оно определено на языке приложения. Этот параметр обязателен.
Cell2	Ячейка в правом нижнем углу диапазона. Может представлять собой объект Microsoft.Office.Interop.Excel.Range, содержащий отдельную ячейку, целый столбец, целую строку, или представлять собой строку с именем ячейки на языке приложения. Этот параметр является необязательным в Visual Basic.

Cell1

Имя диапазона в нотации стиля A1 на языке приложения. Оно может включать оператор диапазона (двоеточие), оператор пересечения (пробел) или оператор объединения (запятая). Оно также может включать знаки доллара, однако они игнорируются. Локально определенное имя можно использовать в любой части диапазона. При использовании имени предполагается, что оно определено на языке приложения. Этот параметр обязателен.

Cell2

Ячейка в правом нижнем углу диапазона. Может представлять собой объект Microsoft.Office.Interop.Excel.Range, содержащий отдельную ячейку, целый столбец, целую строку, или представлять собой строку с именем ячейки на языке приложения. Этот параметр является необязательным в Visual Basic.

При попытке использования свойства Range без указания каких-либо параметров свойство Range получит объект Worksheet._RangeType, который является частью инфраструктуры Visual Studio Tools for Office и не предназначен для использования непосредственно из кода.

Необязательные параметры

Сведения о необязательных параметрах см. в разделе Общие сведения о необязательных параметрах в решениях Office.

Примеры

В следующем пример кода демонстрируются различные способы использования свойства Range для доступа к отдельной ячейке или нескольким ячейкам.

Эта версия предназначена для настройки уровня документа.

Private Sub CompareRangeUsage()
    ' The following line of code specifies a single cell.
    Me.Range("A1").Value2 = "Range 1"

    ' The following line of code specifies multiple cells.
    Me.Range("A3", "B4").Value2 = "Range 2"

    ' The following line of code uses an Excel.Range for 
    ' the second parameter of the Range property.
    Dim range1 As Excel.Range = Me.Range("C8")
    Me.Range("A6", range1).Value2 = "Range 3"
End Sub

private void CompareRangeUsage()
{
    // The following line of code specifies a single cell.
    this.Range["A1", missing].Value2 = "Range 1";

    // The following line of code specifies multiple cells.
    this.Range["A3", "B4"].Value2 = "Range 2";

    // The following line of code uses an Excel.Range for 
    // the second parameter of the Range property.
    Excel.Range range1 = this.Range["C8", missing];
    this.Range["A6", range1].Value2 = "Range 3";
}

Эта версия предназначена для надстройки уровня приложения.

Private Sub CompareRangeUsage()
    Dim vstoWorksheet As Worksheet = _
        CType(Me.Application.ActiveWorkbook.Worksheets(1), Excel.Worksheet) _
        .GetVstoObject()
    ' The following line of code specifies a single cell.
    vstoWorksheet.Range("A1").Value2 = "Range 1"

    ' The following line of code specifies multiple cells.
    vstoWorksheet.Range("A3", "B4").Value2 = "Range 2"

    ' The following line of code uses an Excel.Range for 
    ' the second parameter of the Range property.
    Dim range1 As Excel.Range = vstoWorksheet.Range("C8")
    vstoWorksheet.Range("A6", range1).Value2 = "Range 3"
End Sub

private void CompareRangeUsage()
{                      
    Worksheet vstoWorksheet = ((Excel.Worksheet)
        this.Application.ActiveWorkbook.Worksheets[1]).GetVstoObject();
    // The following line of code specifies a single cell.
    vstoWorksheet.Range["A1", missing].Value2 = "Range 1";

    // The following line of code specifies multiple cells.
    vstoWorksheet.Range["A3", "B4"].Value2 = "Range 2";

    // The following line of code uses an Excel.Range for 
    // the second parameter of the Range property.
    Excel.Range range1 = vstoWorksheet.Range["C8", missing];
    vstoWorksheet.Range["A6", range1].Value2 = "Range 3";
}

Разрешения

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

См. также

Ссылки

Worksheet Класс

Worksheet - члены

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

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

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

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