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

Статья
05/19/2013

Получает ссылку на диапазон для элемента управления 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.

Эта версия предназначена для настройки уровня документа.

    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

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.

См. также

Ссылки

NamedRange Интерфейс

Microsoft.Office.Tools.Excel - пространство имен

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