NamedRange.Address プロパティ
NamedRange コントロールの範囲参照を取得します。
名前空間: Microsoft.Office.Tools.Excel
アセンブリ: Microsoft.Office.Tools.Excel (Microsoft.Office.Tools.Excel.dll 内)
構文
'宣言
ReadOnly Property Address As NamedRange_AddressType
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]);
// 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, this.Cells[3, 3]]);
}
このバージョンは、アプリケーション レベルのアドインに使用されます。
.NET Framework セキュリティ
- 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。