WorksheetBase.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
Ensamblado: Microsoft.Office.Tools.Excel.v4.0.Utilities (en Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)
Sintaxis
'Declaración
Public ReadOnly Property Range As Worksheet_RangeType
public 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 utilizarse 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 ejemplo es opcional en Visual Basic. |
Si intenta usar Range sin especificar parámetros, Range obtendrá un objeto _RangeType que forma parte de la infraestructura de Visual Studio y que no está diseñado para usarlo directamente en el 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 una personalización en el nivel del 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";
}
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.