Propriedade WorksheetBase.Range
Obtém um objeto Microsoft.Office.Interop.Excel.Range que representa uma célula ou um intervalo de células.
Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel.v4.0.Utilities (em Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)
Sintaxe
'Declaração
Public ReadOnly Property Range As Worksheet_RangeType
public Worksheet_RangeType Range { get; }
Valor de propriedade
Tipo: Microsoft.Office.Tools.Excel.Worksheet_RangeType
Um Microsoft.Office.Interop.Excel.Range que representa uma célula ou um intervalo de células.
Comentários
A propriedade de Range destina-se a ser usada com os seguintes parâmetros.
Parâmetro |
Descrição |
|---|---|
Cell1 |
O nome do intervalo na notação em estilo A1 no idioma do aplicativo. Ele pode incluir o operador do intervalo (dois-pontos), o operador de interseção (um espaço) ou o operador de união (uma vírgula). Ele também pode incluir cifrões, mas eles são ignorados. É possível usar um nome definido local em qualquer parte do intervalo. Caso você use um nome, presume-se que o nome esteja no idioma do aplicativo. Este parâmetro é necessário. |
Cell2 |
A célula no canto inferior direito do intervalo. Pode ser um Microsoft.Office.Interop.Excel.Range que contém uma única célula, uma coluna inteira, uma linha inteira ou pode ser uma cadeia de caracteres que nomeia uma única célula na linguagem do aplicativo. Este parâmetro é opcional no Visual Basic. |
Se você tentar usar Range sem especificar quaisquer parâmetros, Range obterá um objeto de _RangeType que é parte da infraestrutura do Visual Studio e não destina-se a ser usado diretamente do seu código.
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 demonstra maneiras diferentes do uso da propriedade Range para acessar uma única célula ou um múltiplas células.
Este exemplo destina-se a uma personalização no nível de documento.
Private Sub CompareRangeUsage()
' The following line of code specifies a single cell.
Me.Range("A1").Value2 = "Range 1"
' The following line of code specifies multiple cells.
Me.Range("A3", "B4").Value2 = "Range 2"
' The following line of code uses an Excel.Range for
' the second parameter of the Range property.
Dim range1 As Excel.Range = Me.Range("C8")
Me.Range("A6", range1).Value2 = "Range 3"
End Sub
private void CompareRangeUsage()
{
// The following line of code specifies a single cell.
this.Range["A1"].Value2 = "Range 1";
// The following line of code specifies multiple cells.
this.Range["A3", "B4"].Value2 = "Range 2";
// The following line of code uses an Excel.Range for
// the second parameter of the Range property.
Excel.Range range1 = this.Range["C8"];
this.Range["A6", range1].Value2 = "Range 3";
}
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.