Worksheet.Range (Propiedad)
Obtiene un objeto Microsoft.Office.Interop.Excel.Range que representa una celda o un rango de celdas.
Espacio de nombres: Microsoft.Office.Tools.Excel
Ensamblados: Microsoft.Office.Tools.Excel (en Microsoft.Office.Tools.Excel.dll)
Microsoft.Office.Tools.Excel.v4.0.Utilities (en Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)
Sintaxis
'Declaración
ReadOnly Property Range As Worksheet_RangeType
Worksheet_RangeType Range { get; }
Valor de propiedad
Tipo: Microsoft.Office.Tools.Excel.Worksheet_RangeType
Un objeto Microsoft.Office.Interop.Excel.Range que representa una celda o un rango de celdas.
Comentarios
La propiedad Range está pensada para ser utilizada con los parámetros siguientes.
Parámetro |
Descripción |
|---|---|
Cell1 |
El nombre del rango en notación de estilo A1 en el lenguaje de la aplicación.Puede incluir el operador de rango (un signo de dos puntos), el operador de intersección (un espacio) o el operador de unión (una coma).También puede incluir signos de dólar, pero se omiten.Puede utilizar un nombre definido local en cualquier parte del rango.Si utiliza un nombre, se supone que el nombre está en el lenguaje de la aplicación.Este parámetro es necesario. |
Cell2 |
La celda de la esquina inferior derecha del rango.Puede ser un objeto Microsoft.Office.Interop.Excel.Range que contiene una única celda, una columna completa, una fila completa o puede ser una cadena que asigna un nombre a una celda única en el lenguaje de la aplicación.Este parámetro es opcional. |
Si usa la propiedad Range sin especificar parámetros, devuelve un objeto Worksheet_RangeType que no está pensado para usarse directamente desde su código.
Parámetros opcionales
Para obtener información sobre parámetros opcionales, vea Parámetros opcionales en las soluciones de Office.
Ejemplos
El ejemplo de código siguiente muestra diferentes maneras de utilizar la propiedad Range para tener acceso a una celda única o a varias celdas.
Se trata de un ejemplo para un complemento en el nivel de la aplicación.
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";
}
Seguridad de .NET Framework
- Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.