Propriedade WorksheetBase.Rows

Artigo
01/09/2014

Obtém um objeto de Range que representa uma ou mais linhas na planilha.

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

Sintaxe

'Declaração
Public ReadOnly Property Rows As Range

public Range Rows { get; }

Valor de propriedade

Tipo: Microsoft.Office.Interop.Excel.Range
Um objeto de Range que representa uma ou mais linhas na planilha.

Comentários

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

Esta propriedade pode ser usada com os seguintes parâmetros opcionais para obter linhas específicas na planilha. 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 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 este 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 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 este parâmetro. Esta propriedade lançará um COMException se você tentar passar um valor para esse parâmetro.

Exemplos

O exemplo de código usa a propriedade de Rows para definir a cor, nome, tamanho, e o arrojo da fonte de todas as células nas primeiras cinco linhas na planilha.

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 Sub SetRowsFont()
    Dim fillRows As Excel.Range = TryCast(Me.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()
{
    Excel.Range fillRows = (Excel.Range)this.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";
}

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

WorksheetBase Classe

Namespace Microsoft.Office.Tools.Excel

Compartilhar via