NamedRange.AddressLocal - свойство

Статья
08/11/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. Если пример выполняется в системе, поддерживающей немецкий язык, отображаются строки адресов «$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 - пространство имен

Поделиться через