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 , oznaczającą komórki lub zakresu komórek.
Uwagi
Range Właściwości jest przeznaczony do użytku z następujących parametrów.
Parametr |
Opis |
|---|---|
Cell1 |
Nazwa zakresu w stylu A1 notacji w języku aplikacji.Może zawierać operator zakresu (dwukropek), operator przecięcia (spacją) lub operator połączenia (przecinek).Może także 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órka w prawym dolnym rogu zakresu.Może być Microsoft.Office.Interop.Excel.Range zawiera pojedynczą komórkę, całą kolumnę, cały wiersz lub może być ciąg nazwy pojedynczej komórki w języku wniosku.Ten parametr jest opcjonalny. |
Klienci korzystający z 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
Aby uzyskać informacje o opcjonalnych parametrów, zobacz Parametry opcjonalne w rozwiązania dla pakietu Office.
Przykłady
Poniższy przykład kodu ilustruje różne sposoby na wykorzystanie Range właściwość, aby uzyskać dostęp do pojedynczej komórki lub kilka komórek.
Ten przykład dotyczy dodatek programu poziomu aplikacji.
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 Przy użyciu bibliotek z częściowo zaufanego kodu..