Proprietà NamedRange.Rows

Articolo
08/11/2011

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.

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

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Vedere anche

Riferimenti

NamedRange Interfaccia

Spazio dei nomi Microsoft.Office.Tools.Excel

Share via