NamedRange.Rows Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém um Range que representa uma ou mais linhas no controle NamedRange.
public Microsoft.Office.Interop.Excel.Range Rows { get; }
Valor da propriedade
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. |