Worksheet.Range プロパティ
セルまたはセルの範囲を表す Microsoft.Office.Interop.Excel.Range オブジェクトを取得します。
名前空間: Microsoft.Office.Tools.Excel
アセンブリ: Microsoft.Office.Tools.Excel (Microsoft.Office.Tools.Excel.dll 内)
構文
'宣言
ReadOnly Property Range As Worksheet_RangeType
Get
Worksheet_RangeType Range { get; }
プロパティ値
型: Microsoft.Office.Tools.Excel.Worksheet_RangeType
セルまたはセルの範囲を表す Microsoft.Office.Interop.Excel.Range オブジェクトです。
解説
Range プロパティは、次のパラメーターと共に使用します。
パラメーター |
説明 |
|---|---|
Cell1 |
アプリケーションの言語で、A1 スタイルで表記した範囲の名前です。 範囲演算子 (コロン)、交差演算子 (空白文字)、UNION 演算子 (コンマ) を含めることができます。 ドル記号を含めることもできますが、無視されます。 範囲の中ではどこでも、ローカルで定義した名前を使うことができます。 名前を使用した場合、その名前はアプリケーションの言語であることが前提です。 このパラメーターは必須です。 |
Cell2 |
範囲の右下隅のセルです。 1 つのセル、列全体、行全体を含む Microsoft.Office.Interop.Excel.Range、または、特定のセルの名前をアプリケーションの言語で表した文字列のいずれかです。 このパラメーターは省略できます。 |
パラメーターを指定せずに Range プロパティを使用すると、コードから直接使用されることを意図していない Worksheet_RangeType オブジェクトが返されます。
省略可能なパラメーター
省略可能なパラメーターについては、「Office ソリューションの省略可能なパラメーター」を参照してください。
例
次のコード例では、1 つまたは複数のセルにアクセスするための Range プロパティの異なる利用法を示します。
この例は、アプリケーション レベルのアドインのために作成されています。
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", missing].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", missing];
vstoWorksheet.Range["A6", range1].Value2 = "Range 3";
}
.NET Framework セキュリティ
- 直前の呼び出し元に対する完全な信頼。 このメンバーは、部分的に信頼されているコードから使用することはできません。 詳細については、「部分信頼コードからのライブラリの使用」を参照してください。