Propriedade Worksheet.Range
Obtém um Microsoft.Office.Interop.Excel.Range objeto que representa uma célula ou um intervalo de células.
Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (em Microsoft.Office.Tools.Excel.dll)
Sintaxe
'Declaração
ReadOnly Property Range As Worksheet_RangeType
Get
Worksheet_RangeType Range { get; }
Valor de propriedade
Tipo: Microsoft.Office.Tools.Excel.Worksheet_RangeType
A Microsoft.Office.Interop.Excel.Range que representa uma célula ou um intervalo de células.
Comentários
O Range propriedade destina-se a ser usado com os seguintes parâmetros.
Parameter |
Description |
|---|---|
Cell1 |
O nome do intervalo na notação de estilo A1 no idioma do aplicativo. Pode incluir o operador de intervalo (dois pontos), o operador de interseção (um espaço) ou o operador de união (vírgula). Ele também pode incluir cifrões, mas elas são ignoradas. Você pode usar um nome definido local em qualquer parte do intervalo. Se você usar um nome, presume-se que o nome no idioma do aplicativo. Este parâmetro é obrigató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 seqüência de caracteres que nomeia uma única célula no idioma do aplicativo. Este parâmetro é opcional. |
Se você usar o Range a propriedade sem especificar quaisquer parâmetros, ele retornará um Worksheet_RangeType objeto que não se destina a ser usado diretamente em seu código.
Optional Parameters
Para obter informações sobre os parâmetros opcionais, consulte Parâmetros opcionais em soluções do Office.
Exemplos
O exemplo de código a seguir demonstra os diferentes maneiras de usar o Range propriedade para acessar uma única célula ou várias células.
Este exemplo é um suplemento em nível de aplicativo.
Private Sub CompareRangeUsage()
Dim NativeWorksheet As Microsoft.Office.Interop.Excel.Worksheet =
Globals.ThisAddIn.Application.ActiveWorksheet("Sheet1")
Dim vstoWorksheet As Microsoft.Office.Tools.Excel.Worksheet =
Globals.Factory.GetVstoObject(NativeWorksheet)
' The following line of code specifies a single cell.
vstoWorksheet.Range("A1").Value2 = "Range 1"
' The following line of code specifies multiple cells.
vstoWorksheet.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 = vstoWorksheet.Range("C8")
vstoWorksheet.Range("A6", range1).Value2 = "Range 3"
End Sub
private void CompareRangeUsage()
{
Worksheet vstoWorksheet = Globals.Factory.GetVstoObject(
this.Application.ActiveWorkbook.Worksheets[1]);
// The following line of code specifies a single cell.
vstoWorksheet.Range["A1", missing].Value2 = "Range 1";
// The following line of code specifies multiple cells.
vstoWorksheet.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 = vstoWorksheet.Range["C8", missing];
vstoWorksheet.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áveis.