Propriedade NamedRange.Rows

Artigo
01/09/2014

Obtém Microsoft.Office.Interop.Excel.Range que representa uma ou mais linhas no controle de NamedRange .

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (em Microsoft.Office.Tools.Excel.dll)

Sintaxe

'Declaração
ReadOnly Property Rows As Range

Range Rows { get; }

Valor de propriedade

Tipo: Microsoft.Office.Interop.Excel.Range
Microsoft.Office.Interop.Excel.Range que representa uma ou mais linhas no controle de NamedRange .

Comentários

Quando usada sem parâmetros, essa propriedade retorna um objeto de Range que contém todas as linhas no intervalo nomeado.

Esta propriedade pode ser usada com os seguintes parâmetros opcionais para obter linhas específicas no intervalo nomeado. Se você usa essa propriedade com parâmetros, o valor de retorno é um objeto que deve ser convertido em Range.

Parâmetro	Descrição
RowIndex	O índice de uma ou mais linhas para obter. Para obter uma única linha, passe um número inteiro que especifica o índice da linha que você deseja obter. Os índices de linha iniciam em 1. Para obter mais linhas contíguos, passe uma cadeia de caracteres com o formato “first row:last row”. Por exemplo, para obter as linhas 1 a 5, passe “1:5”.
ColumnIndex	Não use esse parâmetro. Esta propriedade irá acionar COMException se você tentar passar um valor para este parâmetro.

RowIndex

O índice de uma ou mais linhas para obter.

Para obter uma única linha, passe um número inteiro que especifica o índice da linha que você deseja obter. Os índices de linha iniciam em 1.

Para obter mais linhas contíguos, passe uma cadeia de caracteres com o formato “first row:last row”. Por exemplo, para obter as linhas 1 a 5, passe “1:5”.

ColumnIndex

Não use esse parâmetro. Esta propriedade irá acionar COMException se você tentar passar um valor para este parâmetro.

Exemplos

O exemplo de código a seguir cria NamedRange e usar a propriedade de Rows para definir a cor, nome, tamanho, e o arrojo da fonte de todas as células nas primeiras cinco linhas no intervalo.

Este exemplo é para uma personalização de um documento nível. Para executar esse código, copiá-los em uma das classes de planilha em seu projeto.

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

O exemplo de código a seguir cria NamedRange e usar a propriedade de Rows para determinar quantas linhas existem está no intervalo.

Este exemplo é para uma personalização de um documento nível. Para executar esse código, copiá-los em uma das classes de planilha em seu projeto.

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

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.

Consulte também

Referência

NamedRange Interface

Namespace Microsoft.Office.Tools.Excel

Compartilhar via