Cell

Cell class

Encapsula el objeto que representa una sola celda del Libro de trabajo.

public class Cell

Propiedades

NombreDescripción
BoolValue { get; }Obtiene el valor booleano contenido en la celda.
Column { get; }Obtiene el número de columna (basado en cero) de la celda.
Comment { get; }Obtiene el comentario de esta celda.
ContainsExternalLink { get; }Indica si esta celda contiene un enlace externo. Solo se aplica cuando la celda es una celda de fórmula.
DateTimeValue { get; }Obtiene el valor DateTime contenido en la celda.
DisplayStringValue { get; }Obtiene el valor de cadena con formato de esta celda según el estilo de visualización de la celda.
DoubleValue { get; }Obtiene el valor doble contenido en la celda.
FloatValue { get; }Obtiene el valor flotante contenido en la celda.
Formula { get; set; }Obtiene o establece una fórmula delCell .
FormulaLocal { get; set; }Obtenga la fórmula con formato local de la celda.
HtmlString { get; set; }Obtiene y establece la cadena html que contiene datos y algunos formatos en esta celda.
IntValue { get; }Obtiene el valor entero contenido en la celda.
IsArrayFormula { get; }Indica si la fórmula de la celda es una fórmula matricial.
IsArrayHeader { get; }Indica que la fórmula de la celda es una fórmula de matriz y es la primera celda de la matriz.
IsErrorValue { get; }Comprueba si el valor de esta celda es un error.
IsFormula { get; }Representa si la celda especificada contiene fórmula.
IsMerged { get; }Comprueba si una celda es parte de un rango fusionado o no.
IsNumericValue { get; }Indica si el valor interno de esta celda es numérico (int, double y datetime)
IsSharedFormula { get; }Indica si la fórmula de la celda es parte de una fórmula compartida.
IsStyleSet { get; }Indica si el estilo de la celda está configurado. Si devuelve falso, significa que esta celda tiene un formato de celda predeterminado.
IsTableFormula { get; }Indica si esta celda es parte de la fórmula de la tabla.
Name { get; }Obtiene el nombre de la celda.
NumberCategoryType { get; }Representa el tipo de categoría del formato de número de esta celda.
R1C1Formula { get; set; }Obtiene o establece una fórmula R1C1 delCell .
Row { get; }Obtiene el número de fila (basado en cero) de la celda.
SharedStyleIndex { get; }Obtiene el índice de estilo compartido de la celda en el grupo de estilos.
StringValue { get; }Obtiene el valor de cadena contenido en la celda. Si el tipo de esta celda es una cadena, devuelva el valor de la cadena en sí mismo. Para otros tipos de celda, se devolverá el valor de la cadena con formato (formateado con el estilo especificado de esta celda). El valor de la celda con formato es el mismo que puede obtener de Excel al copiar una celda como texto (como copiar la celda al editor de texto o exportar a csv).
Type { get; }Representa el tipo de valor de celda.
Value { get; set; }Obtiene el valor contenido en esta celda.
Worksheet { get; }Obtiene la hoja de cálculo principal.

Métodos

NombreDescripción
Calculate(CalculationOptions)Calcula la fórmula de la celda.
Characters(int, int)Devuelve un objeto Characters que representa un rango de caracteres dentro del texto de la celda.
Copy(Cell)Copia datos de una celda de origen.
Equals(Cell)Comprueba si este objeto se refiere a la misma celda con otro objeto de celda.
override Equals(object)Comprueba si este objeto hace referencia a la misma celda con otro.
GetArrayRange()Obtiene el rango de la matriz si la fórmula de la celda es una fórmula de matriz.
GetCharacters()Devuelve todos los objetos Characters que representan un rango de caracteres dentro del texto de la celda.
GetCharacters(bool)Devuelve todos los objetos Characters que representan un rango de caracteres dentro del texto de la celda.
GetConditionalFormattingResult()Obtiene el resultado del formato condicional.
GetDependents(bool)Obtiene todas las celdas cuya fórmula hace referencia directamente a esta celda.
GetDependentsInCalculation(bool)Obtiene todas las celdas cuyo resultado calculado depende de esta celda.
GetDisplayStyle()Obtiene el estilo de visualización de la celda. Si esta celda también se ve afectada por otras configuraciones, como formato condicional, lista de objetos, etc., entonces el estilo de visualización puede ser diferente de cell.GetStyle().
GetDisplayStyle(bool)Obtiene el estilo de visualización de la celda. Si la celda tiene formato condicional, el estilo de visualización no es el mismo que el de la celda.GetStyle().
GetFormatConditions()Obtiene las condiciones de formato que se aplican a esta celda.
GetFormula(bool, bool)Obtenga la fórmula de esta celda.
override GetHashCode()Sirve como una función hash para un tipo particular.
GetHeightOfValue()Obtiene la altura del valor en unidades de píxeles.
GetHtmlString(bool)Obtiene la cadena html que contiene datos y algunos formatos en esta celda.
GetMergedRange()Devuelve unRange objeto que representa un rango fusionado.
GetPrecedents()Obtiene todas las referencias que aparecen en la fórmula de esta celda.
GetPrecedentsInCalculation()Obtiene todos los precedentes (referencia a celdas en el libro de trabajo actual) usados por la fórmula de esta celda al calcularla.
GetStringValue(CellValueFormatStrategy)Obtiene el valor de cadena por estrategia formateada específica.
GetStyle()Obtiene el estilo de celda.
GetStyle(bool)Si checkBorders es verdadero, verifica si los bordes de otras celdas afectarán el estilo de esta celda.
GetTable()Obtiene la tabla que contiene esta celda.
GetValidation()Obtiene la validación aplicada a esta celda.
GetValidationValue()Obtiene el valor de validación que aplicó a esta celda.
GetWidthOfValue()Obtiene el ancho del valor en unidades de píxeles.
IsRichText()Indica si el valor de la cadena de celdas es un texto enriquecido.
PutValue(bool)Pone un valor booleano en la celda.
PutValue(DateTime)Pone un valor DateTime en la celda.
PutValue(double)Pone un valor doble en la celda.
PutValue(int)Pone un valor entero en la celda.
PutValue(object)Pone un valor de objeto en la celda.
PutValue(string)Pone un valor de cadena en la celda.
PutValue(string, bool)Pone un valor de cadena en la celda y convierte el valor a otro tipo de datos si corresponde.
PutValue(string, bool, bool)Pone un valor en la celda, si corresponde, el valor se convertirá a otro tipo de datos y se restablecerá el formato de número de la celda.
RemoveArrayFormula(bool)Eliminar fórmula matricial.
SetArrayFormula(string, int, int)Establece una fórmula de matriz (fórmula de matriz heredada ingresada mediante CTRL+MAYÚS+ENTRAR en MS Excel) en un rango de celdas.
SetArrayFormula(string, int, int, FormulaParseOptions)Establece una fórmula de matriz en un rango de celdas.
SetArrayFormula(string, int, int, FormulaParseOptions, object[][])Establece una fórmula de matriz en un rango de celdas.
SetCharacters(FontSetting[])Establece el formato de texto enriquecido de la celda.
SetDynamicArrayFormula(string, FormulaParseOptions, bool)Establece la fórmula de matriz dinámica y hace que la fórmula se extienda a las celdas vecinas si es posible.
SetDynamicArrayFormula(string, FormulaParseOptions, object[][], bool, bool)Establece la fórmula de matriz dinámica y hace que la fórmula se extienda a las celdas vecinas si es posible.
SetFormula(string, object)Establecer la fórmula y el valor de la fórmula.
SetFormula(string, FormulaParseOptions, object)Establecer la fórmula y el valor de la fórmula.
SetSharedFormula(string, int, int)Establece una fórmula en un rango de celdas.
SetSharedFormula(string, int, int, FormulaParseOptions)Establece una fórmula en un rango de celdas.
SetSharedFormula(string, int, int, FormulaParseOptions, object[][])Establece una fórmula en un rango de celdas.
SetStyle(Style)Establece el estilo de celda.
SetStyle(Style, bool)Aplicar el estilo de celda.
SetStyle(Style, StyleFlag)Aplicar el estilo de celda.
override ToString()Devuelve una cadena que representa el objeto Cell actual.

Ejemplos

[C#]

Workbook excel = new Workbook();
Cells cells = excel.Worksheets[0].Cells;

// Poner una cadena en una celda
Cell cell = cells[0, 0];
cell.PutValue("Hello");

string first = cell.StringValue;
	
// Poner un entero en una celda
cell = cells["B1"];
cell.PutValue(12);

int second = cell.IntValue;

//Pon un doble en una celda
cell = cells[0, 2];
cell.PutValue(-1.234);

double third = cell.DoubleValue;

// Poner una fórmula en una celda
cell = cells["D1"];
cell.Formula = "=B1 + C1";

//Pon una fórmula combinada: "sum(average(b1,c1), b1)" a la celda en b2
cell = cells["b2"];
cell.Formula = "=sum(average(b1,c1), b1)";

//Establece el estilo de una celda
Style style = cell.GetStyle();
//Establecer color de fondo
style.BackgroundColor = Color.Yellow;
//Establecer el formato de una celda
style.Font.Name = "Courier New";
style.VerticalAlignment = TextAlignmentType.Top;
cell.SetStyle(style);



[Visual Basic]

Dim excel as Workbook = new Workbook()
Dim cells as Cells = exce.Worksheets(0).Cells

'Poner una cadena en una celda
Dim cell as Cell = cells(0, 0)
cell.PutValue("Hello")

Dim first as String = cell.StringValue
	
// Poner un entero en una celda
cell = cells("B1")
cell.PutValue(12)

Dim second as Integer = cell.IntValue

//Pon un doble en una celda
cell = cells(0, 2)
cell.PutValue(-1.234)

Dim third as Double = cell.DoubleValue

// Poner una fórmula en una celda
cell = cells("D1")
cell.Formula = "=B1 + C1"

//Pon una fórmula combinada: "sum(average(b1,c1), b1)" a la celda en b2
cell = cells("b2")
cell.Formula = "=sum(average(b1,c1), b1)"
	
//Establece el estilo de una celda
Dim style as Style = cell.GetStyle()

//Establecer color de fondo
style.BackgroundColor = Color.Yellow
//Establecer fuente de una celda
style.Font.Name = "Courier New"
style.VerticalAlignment = TextAlignmentType.Top
cell.SetStyle(style)

Ver también