NamedRange コントロールの範囲参照を取得します。
名前空間: Microsoft.Office.Tools.Excel
アセンブリ: Microsoft.Office.Tools.Excel (Microsoft.Office.Tools.Excel.dll 内)
構文
'宣言
ReadOnly Property Address As NamedRange_AddressType
Get
NamedRange_AddressType Address { get; }
プロパティ値
型: Microsoft.Office.Tools.Excel.NamedRange_AddressType
NamedRange コントロールの範囲参照を R1C1 スタイルまたは A1 スタイルの表記で表した文字列を返します。
解説
Address プロパティは、次のパラメーターと共に使用します。
パラメーター |
説明 |
---|---|
RowAbsolute |
絶対参照として行を返すには true。 既定値は true です。 |
ColumnAbsolute |
絶対参照として列を返すには true。 既定値は true です。 |
ColumnAbsolute |
XlReferenceStyle 値のいずれか。 |
External |
外部参照を返す場合は true です。ローカル参照を返す場合は false です。 既定値は false です。 |
RelativeTo |
開始点を定義する Range。 RowAbsolute および ColumnAbsolute が false で ReferenceStyle が xlR1C1 の場合には、相対参照の開始点を指定する必要があります。 |
パラメーターを指定せずに Address を使用すると、Address は NamedRange_AddressType オブジェクトを取得します。このオブジェクトは、Visual Studio インフラストラクチャの一部であり、コードから直接使用するためのオブジェクトではありません。
参照に複数のセルが含まれている場合、RowAbsolute および ColumnAbsolute はすべての行と列に適用されます。
省略可能なパラメーター
省略可能なパラメーターについては、「Office ソリューションの省略可能なパラメーター」を参照してください。
例
次のコード例は、NamedRange を作成し、その NamedRange のアドレスを 4 種類の形式で表示します。
このバージョンは、ドキュメント レベルのカスタマイズに使用されます。
Private Sub DisplayAddress()
Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
= Me.Controls.AddNamedRange(Me.Range("A2", "C4"), _
"namedRange1")
' The following code will display "$A$2:$C$4".
MessageBox.Show(namedRange1.Address(True, True, _
Excel.XlReferenceStyle.xlA1, False, ))
' The following code will display "$A2:$C4".
MessageBox.Show(namedRange1.Address(False, True, _
Excel.XlReferenceStyle.xlA1, False, ))
' The following code will display "R2C1:R4C3".
MessageBox.Show(namedRange1.Address(True, True, _
Excel.XlReferenceStyle.xlR1C1, False, ))
' The following code will display "R[-1]C[-2]:R[1]C".
MessageBox.Show(namedRange1.Address(False, False, _
Excel.XlReferenceStyle.xlR1C1, False, Me.Cells(3, 3)))
End Sub
private void DisplayAddress()
{
Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
this.Controls.AddNamedRange(this.Range["A2","C4"],
"namedRange1");
// The following code will display "$A$2:$C$4".
MessageBox.Show(namedRange1.Address[true, true,
Excel.XlReferenceStyle.xlA1, false, missing]);
// The following code will display "$A2:$C4".
MessageBox.Show(namedRange1.Address[false, true,
Excel.XlReferenceStyle.xlA1, false, missing]);
// The following code will display "R2C1:R4C3".
MessageBox.Show(namedRange1.Address[true, true,
Excel.XlReferenceStyle.xlR1C1, false, missing]);
// The following code will display "R[-1]C[-2]:R[1]C".
MessageBox.Show(namedRange1.Address[false, false,
Excel.XlReferenceStyle.xlR1C1, false, this.Cells[3, 3]]);
}
このバージョンは、アプリケーション レベルのアドインに使用されます。
Private Sub DisplayAddress()
Dim NativeWorksheet As Microsoft.Office.Interop.Excel.Worksheet =
Globals.ThisAddIn.Application.ActiveSheet
Dim vstoWorksheet As Microsoft.Office.Tools.Excel.Worksheet =
Globals.Factory.GetVstoObject(NativeWorksheet)
Dim namedRange1 As NamedRange = vstoWorksheet.Controls.AddNamedRange( _
vstoWorksheet.Range("A2", "C4"), "namedRange1")
' The following code will display "$A$2:$C$4".
System.Windows.Forms.MessageBox.Show(namedRange1.Address(True, True, _
Excel.XlReferenceStyle.xlA1, False, ))
' The following code will display "$A2:$C4".
System.Windows.Forms.MessageBox.Show(namedRange1.Address(False, True, _
Excel.XlReferenceStyle.xlA1, False, ))
' The following code will display "R2C1:R4C3".
System.Windows.Forms.MessageBox.Show(namedRange1.Address(True, True, _
Excel.XlReferenceStyle.xlR1C1, False, ))
' The following code will display "R[-1]C[-2]:R[1]C".
System.Windows.Forms.MessageBox.Show(namedRange1.Address(False, False, _
Excel.XlReferenceStyle.xlR1C1, False, vstoWorksheet.Cells(3, 3)))
End Sub
private void DisplayAddress()
{
Worksheet vstoWorksheet =
Globals.Factory.GetVstoObject(this.Application.ActiveWorkbook.Worksheets[1]);
NamedRange namedRange1 =
vstoWorksheet.Controls.AddNamedRange(vstoWorksheet.Range["A2", "C4"],
"namedRange1");
// The following code will display "$A$2:$C$4".
System.Windows.Forms.MessageBox.Show(namedRange1.Address[true, true,
Excel.XlReferenceStyle.xlA1, false, missing]);
// The following code will display "$A2:$C4".
System.Windows.Forms.MessageBox.Show(namedRange1.Address[false, true,
Excel.XlReferenceStyle.xlA1, false, missing]);
// The following code will display "R2C1:R4C3".
System.Windows.Forms.MessageBox.Show(namedRange1.Address[true, true,
Excel.XlReferenceStyle.xlR1C1, false, missing]);
// The following code will display "R[-1]C[-2]:R[1]C".
System.Windows.Forms.MessageBox.Show(namedRange1.Address[false, false,
Excel.XlReferenceStyle.xlR1C1, false, vstoWorksheet.Cells[3, 3]]);
}
.NET Framework セキュリティ
- 直前の呼び出し元に対する完全な信頼。 このメンバーは、部分的に信頼されているコードから使用することはできません。 詳細については、「部分信頼コードからのライブラリの使用」を参照してください。