Worksheet.Range - свойство
Возвращает объект Microsoft.Office.Interop.Excel.Range, представляющий ячейку или диапазон ячеек.
Пространство имен: Microsoft.Office.Tools.Excel
Сборка: Microsoft.Office.Tools.Excel (в Microsoft.Office.Tools.Excel.dll)
Синтаксис
'Декларация
ReadOnly Property Range As Worksheet_RangeType
Get
Worksheet_RangeType Range { get; }
Значение свойства
Тип: Microsoft.Office.Tools.Excel.Worksheet_RangeType
Объект Microsoft.Office.Interop.Excel.Range, представляющий ячейку или диапазон ячеек.
Заметки
Свойство Range должно использоваться с указанными ниже параметрами.
Параметр |
Описание |
|---|---|
Cell1 |
Имя диапазона в нотации стиля A1 на языке приложения. Оно может включать оператор диапазона (двоеточие), оператор пересечения (пробел) или оператор объединения (запятая). Оно также может включать знаки доллара, однако они игнорируются. Локально определенное имя можно использовать в любой части диапазона. При использовании имени предполагается, что оно определено на языке приложения. Этот параметр обязателен. |
Cell2 |
Ячейка в правом нижнем углу диапазона. Может представлять собой объект Microsoft.Office.Interop.Excel.Range, содержащий отдельную ячейку, целый столбец, целую строку, или представлять собой строку с именем ячейки на языке приложения. Этот параметр является необязательным. |
Если использовать свойство Range без указания каких-либо параметров, оно вернет объект Worksheet_RangeType, который не предназначен для использования непосредственно из кода.
Необязательные параметры
Сведения о необязательных параметрах см. в разделе Необязательные параметры в решениях Office.
Примеры
В следующем пример кода демонстрируются различные способы использования свойства Range для доступа к отдельной ячейке или нескольким ячейкам.
Этот пример предназначен для надстройки уровня приложения.
Private Sub CompareRangeUsage()
Dim NativeWorksheet As Microsoft.Office.Interop.Excel.Worksheet =
Globals.ThisAddIn.Application.ActiveWorksheet("Sheet1")
Dim vstoWorksheet As Microsoft.Office.Tools.Excel.Worksheet =
Globals.Factory.GetVstoObject(NativeWorksheet)
' 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 = Globals.Factory.GetVstoObject(
this.Application.ActiveWorkbook.Worksheets[1]);
// 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";
}
Безопасность платформы .NET Framework
- Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.