NamedRange.Address Свойство

Определение

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

public Microsoft.Office.Tools.Excel.NamedRange_AddressType Address { get; }

Значение свойства

NamedRange_AddressType

Строка, представляющая ссылку на диапазон элемента управления NamedRange в нотации стиля R1C1 или A1.

Примеры

В следующем примере кода создается объект, NamedRange а затем отображается адрес в NamedRange четырех форматах.

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

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]]);
}
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

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

Комментарии

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.

Применяется к