NamedRange.Rows Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает объект Range, представляющий одну или несколько строк в элементе управления NamedRange.
public Microsoft.Office.Interop.Excel.Range Rows { get; }
Значение свойства
Объект Range, представляющий одну или несколько строк в элементе управления NamedRange.
Примеры
В следующем примере кода создается объект, NamedRange а затем используется Rows свойство для задания цвета, имени, размера и полужирного начертания шрифта для всех ячеек в первых пяти строках в диапазоне.
Этот пример предназначен для настройки на уровне документа. Чтобы выполнить этот код, скопируйте его в один из классов листа в проекте.
private void SetRowsFont()
{
Microsoft.Office.Tools.Excel.NamedRange testRange =
this.Controls.AddNamedRange(this.Range["A1", "J10"],
"TestRange");
testRange.Select();
Excel.Range fillRows = (Excel.Range)testRange.Rows["1:5"];
Excel.Font rowsFont = fillRows.Font;
// Set the font color to blue (RGB value 00 00 FF), and set other font properties.
rowsFont.Color = 0xFF0000;
rowsFont.Name = "Arial";
rowsFont.Size = 14;
rowsFont.Bold = false;
// Test the changes by writing a value to all the row cells.
fillRows.Value2 = "This is a test";
}
Private Sub SetRowsFont()
Dim testRange As Microsoft.Office.Tools.Excel.NamedRange = _
Me.Controls.AddNamedRange(Me.Range("A1", "J10"), _
"TestRange")
testRange.Select()
Dim fillRows As Excel.Range = TryCast(testRange.Rows("1:5"), Excel.Range)
With fillRows.Font
' Set the font color to blue (RGB value 00 00 FF), and set other font properties.
.Color = &HFF0000
.Name = "Arial"
.Size = 14
.Bold = False
End With
' Test the changes by writing a value to all the row cells.
fillRows.Value2 = "This is a test"
End Sub
В следующем примере кода создается объект NamedRange , а затем используется Rows свойство для определения количества строк в диапазоне.
Этот пример предназначен для настройки на уровне документа. Чтобы выполнить этот код, скопируйте его в один из классов листа в проекте.
Microsoft.Office.Tools.Excel.NamedRange compositeRange;
private void DisplayRangeComposition()
{
compositeRange = this.Controls.AddNamedRange(
this.Range["B2", "E5"], "compositeRange");
compositeRange.Cells.Interior.Color = 0xFF00;
MessageBox.Show("The range has " + compositeRange.Count +
" cells.");
MessageBox.Show("The range has " +
compositeRange.Columns.Count + " columns.");
MessageBox.Show("The range has " +
compositeRange.Rows.Count + " rows.");
}
Private compositeRange As Microsoft.Office.Tools.Excel.NamedRange
Private Sub DisplayRangeComposition()
compositeRange = Me.Controls.AddNamedRange( _
Me.Range("B2", "E5"), "compositeRange")
compositeRange.Cells.Interior.Color = &HFF00
MessageBox.Show("The range has " & _
compositeRange.Count & " cells.")
MessageBox.Show("The range has " & _
compositeRange.Columns.Count & " columns.")
MessageBox.Show("The range has " & _
compositeRange.Rows.Count & " rows.")
End Sub
Комментарии
При использовании без параметров это свойство возвращает Range объект, содержащий все строки в именованном диапазоне.
Это свойство можно использовать со следующими необязательными параметрами для получения конкретных строк в именованном диапазоне. При использовании этого свойства с параметрами возвращаемое значение является объектом, который должен быть приведен к типу Range .
| Параметр | Описание |
|---|---|
RowIndex |
Индекс одной или нескольких строк, которые необходимо получить. Чтобы получить одну строку, передайте целое число, указывающее индекс строки, которую необходимо получить. Индексы строк начинаются с 1. Чтобы получить несколько смежных строк, передайте строку в формате " first row : last row ". Например, чтобы получить строки с 1 по 5, передайте "1:5". |
ColumnIndex |
Этот параметр не используется. Это свойство вызовет исключение COMException при попытке передать значение этому параметру. |