Propriedade NamedRange.AddressLocal

Artigo
01/09/2014

Obtém a referência de intervalo para o controle de NamedRange no idioma do usuário.

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

Sintaxe

'Declaração
ReadOnly Property AddressLocal As NamedRange_AddressLocalType

NamedRange_AddressLocalType AddressLocal { get; }

Valor de propriedade

Tipo: Microsoft.Office.Tools.Excel.NamedRange_AddressLocalType
Uma cadeia de caracteres que representa a referência do intervalo de controle de NamedRange no idioma de usuário e a notação de R1C1-stye ou de A1-style.

Comentários

A propriedade de AddressLocal 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 AddressLocal sem especificar quaisquer parâmetros, AddressLocal obterá um objeto de NamedRange_AddressLocalType 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. Se o exemplo é executado em um sistema usando o suporte a linguagem alemão, o exemplo exibirá o endereço cadeia de caracteres “$A$2”, “$A2”, “Z2S2,” e “Z [- 1] S] [- 1”.

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

    Private Sub DisplayAddressLocal()
        'Change system settings to German and test this.
        Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
            = Me.Controls.AddNamedRange(Me.Range("A2", "C4"), _
            "namedRange1")

        ' The following code will display "$A$2".
        MessageBox.Show(namedRange1.AddressLocal(True, True, _
            Excel.XlReferenceStyle.xlA1, False, ))

        ' The following code will display "$A2".
        MessageBox.Show(namedRange1.AddressLocal(False, True, _
            Excel.XlReferenceStyle.xlA1, False, ))

        ' The following code will display "Z2S2".
        MessageBox.Show(namedRange1.AddressLocal(True, True, _
            Excel.XlReferenceStyle.xlR1C1, False, ))

        ' The following code will display "Z[-1]S[-1]".
        MessageBox.Show(namedRange1.AddressLocal(False, False, _
            Excel.XlReferenceStyle.xlR1C1, False, Me.Cells(3, 3)))
    End Sub

private void DisplayAddressLocal()
{
    //Change system settings to German and test this.
    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["A2", "C4"],
        "namedRange1");

    // The following code will display "$A$2".
    MessageBox.Show(namedRange1.AddressLocal[true,
        true, Excel.XlReferenceStyle.xlA1, false]);

    // The following code will display "$A2".
    MessageBox.Show(namedRange1.AddressLocal[false,
        true, Excel.XlReferenceStyle.xlA1, false]);

    // The following code will display "Z2S2".
    MessageBox.Show(namedRange1.AddressLocal[true,
         true, Excel.XlReferenceStyle.xlR1C1, false]);

    // The following code will display "Z[-1]S[-1]".
    MessageBox.Show(namedRange1.AddressLocal[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