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

Статья
08/11/2011

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

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

Синтаксис

'Декларация
ReadOnly Property Rows As Range
    Get

Range Rows { get; }

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

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

Заметки

При использовании без параметров, это свойство возвращает объект Range, который содержит все строки в указанном диапазоне.

Это свойство может использоваться со следующими необязательными параметрами для получения определенных строк в именованном диапазоне. Если это свойство используется с параметрами, возвращаемое значение представляет собой объект, который должен быть приведен к типу Range.

Параметр	Описание
RowIndex	Индекс одной или нескольких получаемых строк. Чтобы получить одну строку, передайте целое число, указывающее индекс строки, которую требуется получить. Индексация строк начинается с 1. Чтобы получить несколько смежных строк, передайте строку в формате "first row:last row". Например, чтобы получить строки с 1 по 5, передайте "1:5".
ColumnIndex	Не следует использовать данный параметр. Это свойство выдаст исключение COMException при попытке передать значение этому параметру.

RowIndex

Индекс одной или нескольких получаемых строк.

Чтобы получить одну строку, передайте целое число, указывающее индекс строки, которую требуется получить. Индексация строк начинается с 1.

Чтобы получить несколько смежных строк, передайте строку в формате "first row:last row". Например, чтобы получить строки с 1 по 5, передайте "1:5".

ColumnIndex

Не следует использовать данный параметр. Это свойство выдаст исключение COMException при попытке передать значение этому параметру.

Примеры

В следующем примере кода создается NamedRange, а затем используется свойство Rows для задания цвета, имени, размера и жирности шрифта всех ячеек в первых пяти строках диапазона.

В этом примере демонстрируется настройка уровня документа. Для выполнения этого кода скопируйте его в один из классов листа в проекте.

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

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", missing];
    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";
}

В следующем примере создается NamedRange, а затем используется свойство 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

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.");
}

Безопасность платформы .NET Framework

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

См. также

Ссылки

NamedRange Интерфейс

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

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