Worksheet.Range-Eigenschaft
Ruft ein Microsoft.Office.Interop.Excel.Range-Objekt ab, das eine Zelle oder einen Zellenbereich darstellt.
Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)
Syntax
'Declaration
ReadOnly Property Range As Worksheet_RangeType
Get
Worksheet_RangeType Range { get; }
Eigenschaftswert
Typ: Microsoft.Office.Tools.Excel.Worksheet_RangeType
Ein Microsoft.Office.Interop.Excel.Range-Objekt, das eine Zelle oder einen Zellenbereich darstellt.
Hinweise
Die Range-Eigenschaft ist für die Verwendung mit den folgenden Parametern vorgesehen.
Parameter |
Beschreibungen |
|---|---|
Cell1 |
Der Name des Bereichs in der Sprache der Anwendung in A1-Notation. Dazu können der Bereichsoperator (Doppelpunkt), der Schnittmengenoperator (Leerzeichen) und der Operator "union" (Komma) gehören. Es können auch Dollarzeichen dazugehören, diese werden jedoch ignoriert. Sie können im gesamten Bereich einen lokalen definierten Namen verwenden. Wenn Sie einen Namen verwenden, wird davon ausgegangen, dass dieser in der Sprache der Anwendung geschrieben wurde. Dieser Parameter ist erforderlich. |
Cell2 |
Die Zelle in der unteren rechten Ecke des Bereichs. Dabei kann es sich um einen Microsoft.Office.Interop.Excel.Range-Bereich handeln, der eine einzelne Zelle, eine ganze Spalte oder eine ganze Zeile enthält. Es kann sich auch um eine Zeichenfolge handeln, die eine einzelne Zelle in der Sprache der Anwendung angibt. Dieser Parameter ist optional. |
Wenn Sie die Range-Eigenschaft ohne Angabe von Parametern verwenden, gibt sie ein Worksheet_RangeType-Objekt zurück, das nicht für die direkte Verwendung in Code vorgesehen ist.
Optionale Parameter
Informationen zu optionalen Parametern finden Sie unter Optionale Parameter in Office-Lösungen.
Beispiele
Im folgenden Codebeispiel werden verschiedene Möglichkeiten der Verwendung der Range-Eigenschaft für den Zugriff auf eine einzelne Zelle oder mehrere Zellen veranschaulicht.
Dieses Beispiel bezieht sich auf ein Add-In auf Anwendungsebene.
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";
}
.NET Framework-Sicherheit
- Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.