NamedRange.AddressLocal プロパティ

[アーティクル]
08/09/2011

NamedRange コントロールの範囲参照をユーザーの言語で取得します。

名前空間: Microsoft.Office.Tools.Excel
アセンブリ: Microsoft.Office.Tools.Excel (Microsoft.Office.Tools.Excel.dll 内)

構文

'宣言
ReadOnly Property AddressLocal As NamedRange_AddressLocalType
    Get

NamedRange_AddressLocalType AddressLocal { get; }

プロパティ値

型: Microsoft.Office.Tools.Excel.NamedRange_AddressLocalType
NamedRange コントロールの範囲参照をユーザーの言語で表した、R1C1 スタイルまたは A1 スタイルの表記の文字列を返します。

解説

AddressLocal プロパティは、次のパラメーターと共に使用します。

パラメーター	説明
RowAbsolute	絶対参照として行を返すには true。既定値は true です。
ColumnAbsolute	絶対参照として列を返すには true。既定値は true です。
ColumnAbsolute	XlReferenceStyle 値のいずれか。
External	外部参照を返す場合は true です。ローカル参照を返す場合は false です。既定値は false です。
RelativeTo	開始点を定義する Range。 RowAbsolute および ColumnAbsolute が false で ReferenceStyle が xlR1C1 の場合には、相対参照の開始点を指定する必要があります。

パラメーターを指定せずに AddressLocal を使用すると、AddressLocal は NamedRange_AddressLocalType オブジェクトを取得します。このオブジェクトは、Visual Studio インフラストラクチャの一部であり、コードから直接使用するためのオブジェクトではありません。

参照に複数のセルが含まれている場合、RowAbsolute および ColumnAbsolute はすべての行と列に適用されます。

省略可能なパラメーター

省略可能なパラメーターについては、「Office ソリューションの省略可能なパラメーター」を参照してください。

例

次のコード例は、NamedRange を作成し、その NamedRange のアドレスを 4 種類の形式で表示します。この例を、ドイツ語サポートを使用しているシステムで実行した場合、この例は、"$A$2"、"$A2"、"Z2S2"、および "Z[-1]S[-1]" というアドレス文字列を表示します。

このバージョンは、ドキュメントレベルのカスタマイズに使用されます。

    Private Sub DisplayAddressLocal()
        'Change system settings to German and test this.
        Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
            = Me.Controls.AddNamedRange(Me.Range("A2", "C4"), _
            "namedRange1")

        ' The following code will display "$A$2".
        MessageBox.Show(namedRange1.AddressLocal(True, True, _
            Excel.XlReferenceStyle.xlA1, False, ))

        ' The following code will display "$A2".
        MessageBox.Show(namedRange1.AddressLocal(False, True, _
            Excel.XlReferenceStyle.xlA1, False, ))

        ' The following code will display "Z2S2".
        MessageBox.Show(namedRange1.AddressLocal(True, True, _
            Excel.XlReferenceStyle.xlR1C1, False, ))

        ' The following code will display "Z[-1]S[-1]".
        MessageBox.Show(namedRange1.AddressLocal(False, False, _
            Excel.XlReferenceStyle.xlR1C1, False, Me.Cells(3, 3)))
    End Sub

private void DisplayAddressLocal()
{
    //Change system settings to German and test this.
    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["A2", "C4"],
        "namedRange1");

    // The following code will display "$A$2".
    MessageBox.Show(namedRange1.AddressLocal[true,
        true, Excel.XlReferenceStyle.xlA1, false, missing]);

    // The following code will display "$A2".
    MessageBox.Show(namedRange1.AddressLocal[false,
        true, Excel.XlReferenceStyle.xlA1, false, missing]);

    // The following code will display "Z2S2".
    MessageBox.Show(namedRange1.AddressLocal[true,
         true, Excel.XlReferenceStyle.xlR1C1, false, missing]);

    // The following code will display "Z[-1]S[-1]".
    MessageBox.Show(namedRange1.AddressLocal[false,
        false, Excel.XlReferenceStyle.xlR1C1, false, this.Cells[3, 3]]);
}

このバージョンは、アプリケーションレベルのアドインに使用されます。

Private Sub DisplayAddressLocal()
    Dim NativeWorksheet As Microsoft.Office.Interop.Excel.Worksheet =
Globals.ThisAddIn.Application.ActiveSheet
    Dim vstoWorksheet As Microsoft.Office.Tools.Excel.Worksheet =
            Globals.Factory.GetVstoObject(NativeWorksheet)
    'Change system settings to German and test this.
    Dim namedRange1 As NamedRange _
        = vstoWorksheet.Controls.AddNamedRange(vstoWorksheet.Range("A2", "C4"), _
        "namedRange1")

    ' The following code will display "$A$2".
    System.Windows.Forms.MessageBox.Show(namedRange1.AddressLocal(True, True, _
        Excel.XlReferenceStyle.xlA1, False, ))

    ' The following code will display "$A2".
    System.Windows.Forms.MessageBox.Show(namedRange1.AddressLocal(False, True, _
        Excel.XlReferenceStyle.xlA1, False, ))

    ' The following code will display "Z2S2".
    System.Windows.Forms.MessageBox.Show(namedRange1.AddressLocal(True, True, _
        Excel.XlReferenceStyle.xlR1C1, False, ))

    ' The following code will display "Z[-1]S[-1]".
    System.Windows.Forms.MessageBox.Show(namedRange1.AddressLocal(False, False, _
        Excel.XlReferenceStyle.xlR1C1, False, vstoWorksheet.Cells(3, 3)))
End Sub

private void DisplayAddressLocal()
{
    Worksheet vstoWorksheet =
        Globals.Factory.GetVstoObject(this.Application.ActiveWorkbook.Worksheets[1]);
    //Change system settings to German and test this.
    NamedRange namedRange1 =
        vstoWorksheet.Controls.AddNamedRange(
        vstoWorksheet.Range["A2", "C4"],
        "namedRange1");

    // The following code will display "$A$2".
    System.Windows.Forms.MessageBox.Show(namedRange1.AddressLocal[true,
        true, Excel.XlReferenceStyle.xlA1, false, missing]);

    // The following code will display "$A2".
    System.Windows.Forms.MessageBox.Show(namedRange1.AddressLocal[false,
        true, Excel.XlReferenceStyle.xlA1, false, missing]);

    // The following code will display "Z2S2".
    System.Windows.Forms.MessageBox.Show(namedRange1.AddressLocal[true,
         true, Excel.XlReferenceStyle.xlR1C1, false, missing]);

    // The following code will display "Z[-1]S[-1]".
    System.Windows.Forms.MessageBox.Show(namedRange1.AddressLocal[false,
        false, Excel.XlReferenceStyle.xlR1C1, false, 
        vstoWorksheet.Cells[3, 3]]);
}

.NET Framework セキュリティ

直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。

参照

NamedRange インターフェイス

Microsoft.Office.Tools.Excel 名前空間

次の方法で共有

NamedRange.AddressLocal プロパティ

構文

プロパティ値

解説

省略可能なパラメーター

例

.NET Framework セキュリティ

参照

参照

その他のリソース