Właściwość Worksheet.Range —
Pobiera Microsoft.Office.Interop.Excel.Range obiekt, który reprezentuje komórkę lub zakres komórek.
Przestrzeń nazw: Microsoft.Office.Tools.Excel
Zestawy: Microsoft.Office.Tools.Excel (w Microsoft.Office.Tools.Excel.dll)
Microsoft.Office.Tools.Excel.v4.0.Utilities (w Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)
Składnia
'Deklaracja
ReadOnly Property Range As Worksheet_RangeType
Worksheet_RangeType Range { get; }
Wartość właściwości
Typ: Microsoft.Office.Tools.Excel.Worksheet_RangeType
A Microsoft.Office.Interop.Excel.Range reprezentującą komórkę lub zakres komórek.
Uwagi
Range Właściwość ma być używany z następującymi parametrami.
Parametr |
Opis |
|---|---|
Cell1 |
Nazwa zakresu w zapisie stylu A1 w języku aplikacji.Może zawierać operator zakresu (dwukropek), operator przecięcia (spacją) lub operator połączenia (przecinek).Może również zawierać znaki dolara, ale są one ignorowane.Można użyć lokalnej nazwy zdefiniowanej w jakiejkolwiek części zakresu.Jeśli użyta zostanie nazwa nazwa zakłada się w języku aplikacji.Ten parametr jest wymagany. |
Cell2 |
Komórki w prawym dolnym rogu zakresu.Może być Microsoft.Office.Interop.Excel.Range zawierający pojedynczą komórkę, cała kolumna, cały wiersz lub może być ciąg nazwy pojedynczej komórki w języku wniosku.Ten parametr jest opcjonalny. |
Jeśli używasz Range właściwość bez określania żadnych parametrów, to zostanie zwrócona Worksheet_RangeType obiekt, który nie jest przeznaczony do użycia bezpośrednio w kodzie.
Parametry opcjonalne
Informacje na temat parametrów opcjonalnych, zobacz Parametry opcjonalne w rozwiązaniach Office.
Przykłady
Poniższy przykład kodu ilustruje różne sposoby wykorzystania Range właściwość dostępu pojedynczą komórkę lub wiele komórek.
W tym przykładzie jest na poziomie aplikacji dodatek.
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";
}
Zabezpieczenia programu .NET Framework
- Pełne zaufanie do bezpośredniego wywołującego. Tego elementu członkowskiego nie można używać w kodzie częściowo zaufanym. Aby uzyskać więcej informacji, zobacz Używanie bibliotek pochodzących z częściowo zaufanego kodu.