NamedRange.Address Propriedade

Definição

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

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

Valor da propriedade

NamedRange_AddressType

Uma cadeia de caracteres que representa a referência de intervalo do controle NamedRange de estilo R1C1 ou notação de estilo A1.

Exemplos

O exemplo de código a seguir cria um NamedRange e, em seguida, exibe o endereço do NamedRange em quatro formatos.

Esta versão destina-se a uma personalização no nível de documento.

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

Esta versão destina-se a um suplemento no nível de aplicativo.

Comentários

A Address propriedade deve ser usada com os parâmetros a seguir.

Parâmetro Descrição
RowAbsolute truepara retornar a linha como uma referência absoluta. O valor padrão é true.
ColumnAbsolute truepara 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 externa; false para retornar uma referência local. O valor padrão é false.
RelativeTo Um Range que define o ponto de partida. Se RowAbsolute e ColumnAbsolute forem false e ReferenceStyle for xlR1C1, você deverá incluir um ponto de partida para a referência relativa.

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

Se a referência contiver mais de uma célula, RowAbsolute e ColumnAbsolute se aplicar 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.

Aplica-se a