Proprietà Worksheet.Range
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)
Microsoft.Office.Tools.Excel.v4.0.Utilities (in Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)
Sintassi
'Dichiarazione
ReadOnly Property Range As Worksheet_RangeType
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 |
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 è obbligatorio. |
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"].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"];
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.