Propriedade NamedRange.AddressLocal
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.