Propriedade NamedRange.Address

Artigo
01/09/2014

Obtém a referência de intervalo para o controle de NamedRange .

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (em Microsoft.Office.Tools.Excel.dll)

Sintaxe

'Declaração
ReadOnly Property Address As NamedRange_AddressType

NamedRange_AddressType Address { get; }

Valor de propriedade

Tipo: Microsoft.Office.Tools.Excel.NamedRange_AddressType
Uma cadeia de caracteres que representa a referência do intervalo de controle de NamedRange na notação de R1C1-stye ou de A1-style.

Comentários

A propriedade de Address destina-se a ser usada com os seguintes parâmetros.

Parâmetro	Descrição
RowAbsolute	true para retornar a linha como uma referência absoluta. O valor padrão é true.
ColumnAbsolute	true para retornar a coluna como uma referência absoluta. O valor padrão é true.
ColumnAbsolute	Um dos valores de XlReferenceStyle.
External	true para retornar uma referência; externo false para retornar uma referência local. O valor padrão é false.
RelativeTo	Range que define o ponto de partida. Se RowAbsolute e ColumnAbsolute são false, e ReferenceStyle é xlR1C1, você deve incluir um ponto de partida para a referência relativa.

Se você tentar usar Address sem especificar quaisquer parâmetros, Address obterá um objeto de NamedRange_AddressType que é parte da infraestrutura do Visual Studio e não destina-se a ser usado diretamente do seu código.

Se a referência contém mais do que uma célula, RowAbsolute e ColumnAbsolute se aplicam a todas as linhas e colunas.

Parâmetros Opcionais

Para obter informações sobre parâmetros opcionais, consulte Parâmetros opcionais em soluções do Office.

Exemplos

O exemplo de código a seguir cria NamedRange e então exibe o endereço de NamedRange em quatro formatos.

Esta é uma versão para personalização de um documento nível.

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

Esta versão é para um suplemento ao aplicativo.

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.

Consulte também

Referência

NamedRange Interface

Namespace Microsoft.Office.Tools.Excel

Compartilhar via