WorksheetBase.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.v4.0.Utilities (in Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)
Syntax
'Declaration
Public ReadOnly Property Range As Worksheet_RangeType
public 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 |
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 zu verwenden, ohne Parameter anzugeben, ruft Range ein _RangeType-Objekt ab, das Teil der Visual Studio-Infrastruktur ist und nicht für die direkte Verwendung im 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 eine Anpassung auf Dokumentebene.
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
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";
}
.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.