Proprietà Worksheet.Range

Articolo
08/11/2011

Ottiene un oggetto Microsoft.Office.Interop.Excel.Range che rappresenta una cella o un intervallo di celle.

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

Sintassi

'Dichiarazione
ReadOnly Property Range As Worksheet_RangeType
    Get

Worksheet_RangeType Range { get; }

Valore proprietà

Tipo: Microsoft.Office.Tools.Excel.Worksheet_RangeType
Oggetto Microsoft.Office.Interop.Excel.Range che rappresenta una cella o un intervallo di celle.

Note

La proprietà Range deve essere utilizzata con i parametri riportati di seguito.

Parametro	Oggetto di descrizione
Cell1	Nome dell'intervallo in notazione A1 e nella lingua dell'applicazione. Può includere l'operatore di intervallo (i due punti), l'operatore di intersezione (lo spazio) oppure l'operatore di unione (la virgola). Può includere anche i simboli del dollaro, che tuttavia vengono ignorati. È possibile utilizzare un nome definito locale in qualsiasi parte dell'intervallo. Se si utilizza un nome, si presuppone che tale nome sia disponibile nella lingua dell'applicazione. Questo parametro è richiesto.
Cell2	Cella nell'angolo inferiore destro dell'intervallo. Può essere un oggetto Microsoft.Office.Interop.Excel.Range che contiene una singola cella, un'intera colonna, un'intera riga oppure può essere una stringa che corrisponde al nome di una singola cella nella lingua dell'applicazione. Questo parametro è facoltativo.

Cell1

Nome dell'intervallo in notazione A1 e nella lingua dell'applicazione. Può includere l'operatore di intervallo (i due punti), l'operatore di intersezione (lo spazio) oppure l'operatore di unione (la virgola). Può includere anche i simboli del dollaro, che tuttavia vengono ignorati. È possibile utilizzare un nome definito locale in qualsiasi parte dell'intervallo. Se si utilizza un nome, si presuppone che tale nome sia disponibile nella lingua dell'applicazione. Questo parametro è richiesto.

Cell2

Cella nell'angolo inferiore destro dell'intervallo. Può essere un oggetto Microsoft.Office.Interop.Excel.Range che contiene una singola cella, un'intera colonna, un'intera riga oppure può essere una stringa che corrisponde al nome di una singola cella nella lingua dell'applicazione. Questo parametro è facoltativo.

Se si utilizza la proprietà Range senza specificare alcun parametro, viene restituito un oggetto Worksheet_RangeType che non può essere utilizzato direttamente dal codice.

Parametri facoltativi

Per informazioni sui parametri facoltativi, vedere Parametri facoltativi nelle soluzioni Office.

Esempi

Nell'esempio di codice riportato di seguito vengono illustrati differenti modi di utilizzo della proprietà Range per accedere a una singola cella o a più celle.

Questo esempio è valido per un componente aggiuntivo a livello di applicazione.

Private Sub CompareRangeUsage()

    Dim NativeWorksheet As Microsoft.Office.Interop.Excel.Worksheet =
        Globals.ThisAddIn.Application.ActiveWorksheet("Sheet1")
    Dim vstoWorksheet As Microsoft.Office.Tools.Excel.Worksheet =
        Globals.Factory.GetVstoObject(NativeWorksheet)

    ' The following line of code specifies a single cell.
    vstoWorksheet.Range("A1").Value2 = "Range 1"

    ' The following line of code specifies multiple cells.
    vstoWorksheet.Range("A3", "B4").Value2 = "Range 2"

    ' The following line of code uses an Excel.Range for 
    ' the second parameter of the Range property.
    Dim range1 As Excel.Range = vstoWorksheet.Range("C8")
    vstoWorksheet.Range("A6", range1).Value2 = "Range 3"
End Sub

private void CompareRangeUsage()
{                      
    Worksheet vstoWorksheet = Globals.Factory.GetVstoObject(
        this.Application.ActiveWorkbook.Worksheets[1]);
    // The following line of code specifies a single cell.
    vstoWorksheet.Range["A1", missing].Value2 = "Range 1";

    // The following line of code specifies multiple cells.
    vstoWorksheet.Range["A3", "B4"].Value2 = "Range 2";

    // The following line of code uses an Excel.Range for 
    // the second parameter of the Range property.
    Excel.Range range1 = vstoWorksheet.Range["C8", missing];
    vstoWorksheet.Range["A6", range1].Value2 = "Range 3";
}

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

Worksheet Interfaccia

Spazio dei nomi Microsoft.Office.Tools.Excel

Condividi tramite