NamedRange.Rows (Propiedad)
Obtiene un objeto Microsoft.Office.Interop.Excel.Range que representa una o más filas del control NamedRange.
Espacio de nombres: Microsoft.Office.Tools.Excel
Ensamblado: Microsoft.Office.Tools.Excel (en Microsoft.Office.Tools.Excel.dll)
Sintaxis
'Declaración
ReadOnly Property Rows As Range
Get
Range Rows { get; }
Valor de propiedad
Tipo: Microsoft.Office.Interop.Excel.Range
Un objeto Microsoft.Office.Interop.Excel.Range que representa una o más filas del control NamedRange.
Comentarios
Cuando se usa sin parámetros, esta propiedad devuelve un objeto Range que contiene todas las filas en el rango con nombre.
Esta propiedad se puede usar con los parámetros opcionales siguientes para obtener filas concretas en el rango con nombre. Si usa esta propiedad con parámetros, el valor devuelto es un objeto que se debe convertir en Range.
Parámetro |
Descripción |
---|---|
RowIndex |
El índice de una o más filas que se va a obtener. Para obtener un fila única, pase un entero que especifica el índice de la fila que desea obtener. Los índices de fila comienzan en 1. Para obtener varias filas contiguas, pase una cadena con el formato "first row:last row". Por ejemplo, para obtener las filas desde 1 a 5, pase "1:5". |
ColumnIndex |
No use este parámetro. Esta propiedad producirá un COMException si intenta pasar un valor a este parámetro. |
Ejemplos
En el ejemplo de código siguiente se crea NamedRange y, a continuación, se usa la propiedad Rows para establecer el color, nombre, tamaño y estado de negrita de la fuente de todas las celdas de las primeras cinco filas del intervalo.
Se trata de un ejemplo para una personalización en el nivel del documento. Para ejecutar este código, cópielo en una de las clases de hoja de cálculo en su proyecto.
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";
}
En el ejemplo de código siguiente se crea NamedRange y, a continuación, se usa la propiedad Rows para determinar cuántas filas hay en el intervalo.
Se trata de un ejemplo para una personalización en el nivel del documento. Para ejecutar este código, cópielo en una de las clases de hoja de cálculo en su proyecto.
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.");
}
Seguridad de .NET Framework
- Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.