Propriedade NamedRange.Rows

Artigo
08/01/2011

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

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

Sintaxe

'Declaração
ReadOnly Property Rows As Range
    Get

Range Rows { get; }

Valor de propriedade

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

Comentários

Quando usado sem parâmetros, essa propriedade retornará um Range objeto 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 do intervalo nomeado. Se você usar essa propriedade com parâmetros, o valor de retorno é um objeto que deve ser convertido em um Range.

Parameter	Description
RowIndex	O índice de uma ou mais linhas para obter. Para obter uma única linha, passe um inteiro que especifica o índice da linha que você deseja obter. Os índices de linha começam com 1. Para obter a várias linhas adjacentes, passe uma seqüência de caracteres com o formato "first row:last row". Por exemplo, para obter 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.

RowIndex

O índice de uma ou mais linhas para obter.

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

Para obter a várias linhas adjacentes, passe uma seqüência de caracteres com o formato "first row:last row". Por exemplo, para obter 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.

Exemplos

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

Este exemplo é para uma personalização em nível de documento. Para executar esse código, copie-o 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", 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";
}

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

Este exemplo é para uma personalização em nível de documento. Para executar esse código, copie-o 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áveis.

Consulte também

Referência

NamedRange Interface

Namespace Microsoft.Office.Tools.Excel

Compartilhar via