NamedRange.Address Свойство (2007 System)

Статья
11/16/2008

Обновлен: Июль 2008

Получает ссылку на диапазон для элемента управления NamedRange.

Пространство имен: Microsoft.Office.Tools.Excel
Сборка: Microsoft.Office.Tools.Excel.v9.0 (в Microsoft.Office.Tools.Excel.v9.0.dll)

Синтаксис

'Декларация
<BrowsableAttribute(False)> _
Public ReadOnly Property Address As NamedRange..::._AddressType
'Применение
Dim instance As NamedRange
Dim value As NamedRange..::._AddressType

value = instance.Address

[BrowsableAttribute(false)]
public 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 Tools for Office и не предназначен для использования непосредственно из кода.

Если ссылка содержит несколько ячеек, параметры 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, 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 vstoWorksheet As Worksheet = CType( _
        Me.Application.ActiveWorkbook.Worksheets(1),  _
        Excel.Worksheet).GetVstoObject()
    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 = ((Excel.Worksheet)
        this.Application.ActiveWorkbook.Worksheets[1]).GetVstoObject();
    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]]);
}

Разрешения

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

См. также

Ссылки

NamedRange Класс

NamedRange - члены

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

Журнал изменений

Дата	Журнал событий	Причина
Июль 2008	Добавлена версия кода для надстройки уровня приложения.	Изменение функции SP1.

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