Propriedade Worksheet.Range

Artigo
01/09/2014

Obtém um objeto de Microsoft.Office.Interop.Excel.Range que representa uma célula ou um intervalo das células.

Namespace: Microsoft.Office.Tools.Excel
Assemblies: Microsoft.Office.Tools.Excel (em Microsoft.Office.Tools.Excel.dll)
Microsoft.Office.Tools.Excel.v4.0.Utilities (em Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Sintaxe

'Declaração
ReadOnly Property Range As Worksheet_RangeType

Worksheet_RangeType Range { get; }

Valor de propriedade

Tipo: Microsoft.Office.Tools.Excel.Worksheet_RangeType
Microsoft.Office.Interop.Excel.Range que representa uma célula ou um intervalo das 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 de A1-style no idioma de aplicativo. 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). Também pode fechar cifrões, mas são ignorados. Você pode usar um nome definido local em qualquer parte do intervalo. Se você usar um nome, o nome é assumido ser no idioma do aplicativo. Esse parâmetro é necessário.
Cell2	A célula no canto inferior direito do intervalo. Pode ser 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 nomeie uma única célula na linguagem do aplicativo. Esse parâmetro é opcional.

Cell1

O nome do intervalo na notação de A1-style no idioma de aplicativo. 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). Também pode fechar cifrões, mas são ignorados. Você pode usar um nome definido local em qualquer parte do intervalo. Se você usar um nome, o nome é assumido ser no idioma do aplicativo. Esse parâmetro é necessário.

Cell2

A célula no canto inferior direito do intervalo. Pode ser 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 nomeie uma única célula na linguagem do aplicativo. Esse parâmetro é opcional.

Se você usar a propriedade de Range sem especificar quaisquer parâmetros, retornará um objeto de Worksheet_RangeType que 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 é para um suplemento ao 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"].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"];
    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ável.

Consulte também

Referência

Worksheet Interface

Namespace Microsoft.Office.Tools.Excel

Compartilhar via