WorksheetBase.Range Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft ein Range-Objekt ab, das eine Zelle oder einen Zellenbereich darstellt.
public Microsoft.Office.Tools.Excel.Worksheet_RangeType Range { get; }
Eigenschaftswert
Ein Range-Objekt, das eine Zelle oder einen Zellenbereich darstellt.
Beispiele
Im folgenden Codebeispiel werden verschiedene Möglichkeiten zur Verwendung der- Range Eigenschaft für den Zugriff auf eine einzelne Zelle oder auf mehrere Zellen veranschaulicht.
Dieses Beispiel gilt für eine Anpassung auf Dokument Ebene.
private void CompareRangeUsage()
{
// The following line of code specifies a single cell.
this.Range["A1"].Value2 = "Range 1";
// The following line of code specifies multiple cells.
this.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 = this.Range["C8"];
this.Range["A6", range1].Value2 = "Range 3";
}
Private Sub CompareRangeUsage()
' The following line of code specifies a single cell.
Me.Range("A1").Value2 = "Range 1"
' The following line of code specifies multiple cells.
Me.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 = Me.Range("C8")
Me.Range("A6", range1).Value2 = "Range 3"
End Sub
Hinweise
Die- Range Eigenschaft ist für die Verwendung mit den folgenden Parametern vorgesehen.
| Parameter | Beschreibung |
|---|---|
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 in Visual Basic optional. |
Wenn Sie versuchen, Range ohne Angabe von Parametern zu verwenden, erhält Range ein <xref:Microsoft.Office.Tools.Excel.Worksheet._RangeType> -Objekt, das Teil der Visual Studio-Infrastruktur ist und nicht für die direkte Verwendung im Code vorgesehen ist.
Optionale Parameter
Weitere Informationen zu optionalen Parametern finden Sie unter optionale Parameter in Office-Projektmappen.