Condividi tramite


Proprietà NamedRange.Rows

Ottiene un oggetto Microsoft.Office.Interop.Excel.Range che rappresenta una o più righe nel controllo NamedRange.

Spazio dei nomi:  Microsoft.Office.Tools.Excel
Assembly:  Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Sintassi

'Dichiarazione
ReadOnly Property Rows As Range
    Get
Range Rows { get; }

Valore proprietà

Tipo: Microsoft.Office.Interop.Excel.Range
Microsoft.Office.Interop.Excel.Range che rappresenta una o più righe nel controllo NamedRange.

Note

Quando utilizzata senza parametri, questa proprietà restituisce un oggetto Range che contiene tutte le righe nell'intervallo denominato.

Questa proprietà può essere utilizzata con i parametri facoltativi seguenti per ottenere righe specifiche nell'intervallo denominato. Se si utilizza questa proprietà con i parametri, il valore restituito è un oggetto di cui deve essere eseguito il cast su un oggetto Range.

Parametro

Oggetto di descrizione

RowIndex

Indice di una o più righe da ottenere.

Per ottenere una sola riga, passare un intero che specifica l'indice della riga da ottenere. Gli indici di riga iniziano a 1.

Per ottenere più righe contigue, passare a una stringa con il formato "first row:last row". Ad esempio, per ottenere le righe che vanno da 1 a 5, passare "1:5".

ColumnIndex

Non utilizzare questo parametro. Questa proprietà genererà un oggetto COMException se si tenta di passare un valore a questo parametro.

Esempi

Nell'esempio di codice riportato di seguito viene creato NamedRange, quindi viene utilizzata la proprietà Rowsper impostare il colore, il nome, la dimensione e il grassetto del carattere di tutte le celle nelle prime cinque righe dell'intervallo.

Questo esempio è valido per una personalizzazione a livello di documento. Per eseguire questo codice, copiarlo in una delle classi del foglio grafico nel progetto.

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";
}

Nell'esempio di codice riportato di seguito viene creato NamedRange, quindi viene utilizzata la proprietà Rows per determinare quante righe si trovano nell'intervallo.

Questo esempio è valido per una personalizzazione a livello di documento. Per eseguire questo codice, copiarlo in una delle classi del foglio grafico nel progetto.

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.");
}

Sicurezza di .NET Framework

Vedere anche

Riferimenti

NamedRange Interfaccia

Spazio dei nomi Microsoft.Office.Tools.Excel