NamedRange.Rows Propriedade

Definição

Obtém um Range que representa uma ou mais linhas no controle NamedRange.

public Microsoft.Office.Interop.Excel.Range Rows { get; }

Valor da propriedade

Range

Um Range que representa uma ou mais linhas no controle NamedRange.

Exemplos

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

Este exemplo destina-se a uma personalização no nível de documento. Para executar esse código, copie-o para uma das classes de planilha no projeto.

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

O exemplo de código a seguir cria um NamedRange e, em seguida, usa a Rows propriedade para determinar quantas linhas existem no intervalo.

Este exemplo destina-se a uma personalização no nível de documento. Para executar esse código, copie-o para uma das classes de planilha no projeto.

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

Comentários

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

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

Parâmetro Descrição
RowIndex O índice de uma ou mais linhas a serem obtidas.

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

Para obter várias linhas contíguas, passe uma cadeia de caracteres com o formato " first row : last row ". Por exemplo, para obter as linhas de 1 a 5, passe "1:5".
ColumnIndex Não use esse parâmetro. Esta propriedade lançará um COMException se você tentar passar um valor para esse parâmetro.

Aplica-se a