NamedRange.Address Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém a referência do intervalo para o controle NamedRange.
public Microsoft.Office.Tools.Excel.NamedRange_AddressType Address { get; }
Valor da propriedade
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.