Worksheet.Range – vlastnost

Článek
05/14/2013

Získá Microsoft.Office.Interop.Excel.Range objekt, který představuje buňku nebo oblast buněk.

Obor názvů: Microsoft.Office.Tools.Excel
Sestavení: Microsoft.Office.Tools.Excel (v Microsoft.Office.Tools.Excel.dll)
Microsoft.Office.Tools.Excel.v4.0.Utilities (v Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Syntaxe

'Deklarace
ReadOnly Property Range As Worksheet_RangeType

Worksheet_RangeType Range { get; }

Hodnota vlastnosti

Typ: Microsoft.Office.Tools.Excel.Worksheet_RangeType
A Microsoft.Office.Interop.Excel.Range , která představuje buňku nebo oblast buněk.

Poznámky

Range Vlastnost je určena pro použití s následujícími parametry.

Parametr	Description
Cell1	Název oblasti v zápisu styl A1 v jazyce aplikace.Může zahrnovat operátor range (dvojtečka), operátor průniku (mezera) nebo operátor sjednocení (středník).Může také obsahovat znaky dolaru, ale jsou ignorovány.Můžete použít místní název definovaný v jakoukoli část rozsahu.Používáte-li název, název považován v jazyce aplikace.Tento parametr je povinný.
Cell2	Na buňku v pravém dolním rohu oblasti.Může být Microsoft.Office.Interop.Excel.Range , který obsahuje jedinou buňku, celý sloupec, celý řádek nebo může být řetězec, který pojmenovává jedinou buňku v jazyce aplikace.Tento parametr je volitelný.

Použijete-li Range vlastnost bez zadání parametrů, budou vracet Worksheet_RangeType objekt, který není určen pro použití přímo v kódu.

Volitelné parametry

Informace o volitelných parametrů naleznete v tématu Volitelné parametry v Office Solutions.

Příklady

Následující příklad kódu ukazuje různé způsoby použití Range vlastnost pro přístup jedné nebo více buněk.

V tomto příkladu je doplněk aplikační úrovni.

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";
}

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.

Viz také

Referenční dokumentace

Worksheet Rozhraní

Microsoft.Office.Tools.Excel – obor názvů

Sdílet prostřednictvím