Class Cell
Namespace: Aspose.Cells
Assembly: Aspose.Cells.dll (25.2.0)
Encapsula el objeto que representa una única celda de un libro de trabajo.
public class Cell
Herencia
Miembros heredados
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Ejemplos
Workbook excel = new Workbook();
Cells cells = excel.Worksheets[0].Cells;
//Colocar una cadena en una celda
Cell cell = cells[0, 0];
cell.PutValue("Hola");
string first = cell.StringValue;
//Colocar un entero en una celda
cell = cells["B1"];
cell.PutValue(12);
int second = cell.IntValue;
//Colocar un doble en una celda
cell = cells[0, 2];
cell.PutValue(-1.234);
double third = cell.DoubleValue;
//Colocar una fórmula en una celda
cell = cells["D1"];
cell.Formula = "=B1 + C1";
//Colocar una fórmula combinada: "sum(average(b1,c1), b1)" en la celda b2
cell = cells["b2"];
cell.Formula = "=sum(average(b1,c1), b1)";
//Establecer el estilo de una celda
Style style = cell.GetStyle();
//Establecer el 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);
Dim excel as Workbook = new Workbook()
Dim cells as Cells = exce.Worksheets(0).Cells
'Colocar una cadena en una celda
Dim cell as Cell = cells(0, 0)
cell.PutValue("Hola")
Dim first as String = cell.StringValue
'Colocar un entero en una celda
cell = cells("B1")
cell.PutValue(12)
Dim second as Integer = cell.IntValue
'Colocar un doble en una celda
cell = cells(0, 2)
cell.PutValue(-1.234)
Dim third as Double = cell.DoubleValue
'Colocar una fórmula en una celda
cell = cells("D1")
cell.Formula = "=B1 + C1"
'Colocar una fórmula combinada: "sum(average(b1,c1), b1)" en la celda b2
cell = cells("b2")
cell.Formula = "=sum(average(b1,c1), b1)"
'Establecer el estilo de una celda
Dim style as Style = cell.GetStyle()
'Establecer el color de fondo
style.BackgroundColor = Color.Yellow
'Establecer la fuente de una celda
style.Font.Name = "Courier New"
style.VerticalAlignment = TextAlignmentType.Top
cell.SetStyle(style)
Propiedades
BoolValue
Obtiene el valor booleano contenido en la celda.
public bool BoolValue { get; }
Valor de la propiedad
Column
Obtiene el número de columna (basado en cero) de la celda.
public int Column { get; }
Valor de la propiedad
Comment
Obtiene el comentario de esta celda.
public Comment Comment { get; }
Valor de la propiedad
Observaciones
Si no hay un comentario aplicable a la celda, devuelve null.
ContainsExternalLink
Indica si esta celda contiene un enlace externo. Solo se aplica cuando la celda es una celda de fórmula.
public bool ContainsExternalLink { get; }
Valor de la propiedad
DateTimeValue
Obtiene el valor DateTime contenido en la celda.
public DateTime DateTimeValue { get; }
Valor de la propiedad
DisplayStringValue
Obtiene el valor de cadena formateado de esta celda según el estilo de visualización de la celda.
public string DisplayStringValue { get; }
Valor de la propiedad
DoubleValue
Obtiene el valor doble contenido en la celda.
public double DoubleValue { get; }
Valor de la propiedad
EmbeddedImage
Obtiene y establece la imagen incrustada en la celda.
public byte[] EmbeddedImage { get; set; }
Valor de la propiedad
byte[]
FloatValue
Obtiene el valor flotante contenido en la celda.
public float FloatValue { get; }
Valor de la propiedad
Formula
Obtiene o establece una fórmula de la Aspose.Cells.Cell.
public string Formula { get; set; }
Valor de la propiedad
Ejemplos
Workbook excel = new Workbook();
Cells cells = excel.Worksheets[0].Cells;
cells["B6"].Formula = "=SUM(B2:B5, E1) + sheet1!A1";
Dim excel As Workbook = New Workbook()
Dim cells As Cells = excel.Worksheets(0).Cells
cells("B6").Formula = "=SUM(B2:B5, E1) + sheet1!A1"
Observaciones
Una cadena de fórmula siempre comienza con un signo igual (=). Y siempre use coma(,) como delimitador de parámetros, como “=SUM(A1, E1, H2)”.
FormulaLocal
Obtiene la fórmula formateada según la localidad de la celda.
public string FormulaLocal { get; set; }
Valor de la propiedad
HasCustomStyle
Indica si esta celda tiene configuraciones de estilo personalizadas (diferentes de la predeterminada heredada de la fila, columna o libro de trabajo correspondiente).
public bool HasCustomStyle { get; }
Valor de la propiedad
HtmlString
Obtiene y establece la cadena html que contiene datos y algunos formatos en esta celda.
public string HtmlString { get; set; }
Valor de la propiedad
IntValue
Obtiene el valor entero contenido en la celda.
public int IntValue { get; }
Valor de la propiedad
IsArrayFormula
Indica si la fórmula de la celda es una fórmula de matriz.
public bool IsArrayFormula { get; }
Valor de la propiedad
IsArrayHeader
Indica que la fórmula de la celda es una fórmula de matriz y es la primera celda de la matriz.
public bool IsArrayHeader { get; }
Valor de la propiedad
IsCheckBoxStyle
Indica si se establece esta celda como una casilla de verificación.
public bool IsCheckBoxStyle { get; set; }
Valor de la propiedad
IsDynamicArrayFormula
Indica si la fórmula de la celda es una fórmula de matriz dinámica (true) o una fórmula de matriz heredada (false).
public bool IsDynamicArrayFormula { get; }
Valor de la propiedad
IsErrorValue
Verifica si el valor de esta celda es un error.
public bool IsErrorValue { get; }
Valor de la propiedad
Observaciones
También se aplica a la celda de fórmula para verificar si el resultado calculado es un error.
IsFormula
Representa si la celda especificada contiene fórmula.
public bool IsFormula { get; }
Valor de la propiedad
IsMerged
Verifica si una celda es parte de un rango combinado o no.
public bool IsMerged { get; }
Valor de la propiedad
IsNumericValue
Indica si el valor de esta celda es numérico (int, double y datetime).
public bool IsNumericValue { get; }
Valor de la propiedad
Observaciones
También se aplica a la celda de fórmula para verificar el resultado calculado.
IsSharedFormula
Indica si la fórmula de la celda es parte de una fórmula compartida.
public bool IsSharedFormula { get; }
Valor de la propiedad
IsStyleSet
Indica si el estilo de la celda está establecido. Si devuelve falso, significa que esta celda tiene un formato de celda predeterminado.
public bool IsStyleSet { get; }
Valor de la propiedad
IsTableFormula
Indica si esta celda es parte de una fórmula de tabla.
public bool IsTableFormula { get; }
Valor de la propiedad
Name
Obtiene el nombre de la celda.
public string Name { get; }
Valor de la propiedad
Observaciones
Un nombre de celda incluye su letra de columna y número de fila. Por ejemplo, el nombre de una celda en la fila 0 y columna 0 es A1.
NumberCategoryType
Representa el tipo de categoría del formato numérico de esta celda.
public NumberCategoryType NumberCategoryType { get; }
Valor de la propiedad
Observaciones
Cuando el patrón de formato de la celda se combina con patrones de formato condicional, el tipo devuelto corresponde a la parte que se utiliza para el valor actual de esta celda. Por ejemplo, si el patrón de formato para esta celda es “#,##0;(#,##0);”-";@", entonces cuando el valor de la celda es numérico y no 0, el tipo devuelto es Aspose.Cells.NumberCategoryType.Number; cuando el valor de la celda es 0 o no es un valor numérico, el tipo devuelto es Aspose.Cells.NumberCategoryType.Text.
R1C1Formula
Obtiene o establece una fórmula R1C1 de la Aspose.Cells.Cell.
public string R1C1Formula { get; set; }
Valor de la propiedad
Row
Obtiene el número de fila (basado en cero) de la celda.
public int Row { get; }
Valor de la propiedad
SharedStyleIndex
Obtiene el índice de estilo compartido de la celda en el grupo de estilos.
public int SharedStyleIndex { get; }
Valor de la propiedad
StringValue
Obtiene el valor de cadena contenido en la celda. Si el tipo de esta celda es cadena, entonces devuelve el valor de cadena en sí. Para otros tipos de celda, se devolverá el valor de cadena formateado (formateado con el estilo especificado de esta celda). El valor de la celda formateada es el mismo que el que se puede obtener de Excel al copiar una celda como texto (como copiar la celda a un editor de texto o exportar a csv).
public string StringValue { get; }
Valor de la propiedad
Type
Representa el tipo de valor de la celda.
public CellValueType Type { get; }
Valor de la propiedad
Value
Obtiene/establece el valor contenido en esta celda.
public object Value { get; set; }
Valor de la propiedad
Observaciones
Tipo posible:
null,
Booleano,
DateTime,
Doble,
Entero
Cadena.
Para el valor int, puede devolverse como un objeto Integer o un objeto Double. Y no hay garantía de que el valor devuelto se mantenga siempre como el mismo tipo de objeto.Worksheet
Obtiene la hoja de trabajo padre.
public Worksheet Worksheet { get; }
Valor de la propiedad
Métodos
Calculate(CalculationOptions)
Calcula la fórmula de la celda.
public void Calculate(CalculationOptions options)
Parámetros
options
CalculationOptions
Opciones para el cálculo
Characters(int, int)
Devuelve un objeto Characters que representa un rango de caracteres dentro del texto de la celda.
public FontSetting Characters(int startIndex, int length)
Parámetros
startIndex
int
El índice del inicio del carácter.
length
int
El número de caracteres.
Devuelve
Objeto Characters.
Ejemplos
Workbook excel = new Workbook();
Cells cells = excel.Worksheets[0].Cells;
cells["A1"].PutValue("Helloworld");
cells["A1"].Characters(5, 5).Font.IsBold = true;
cells["A1"].Characters(5, 5).Font.Color = Color.Blue;
Dim excel as Workbook = new Workbook()
Dim cells as Cells = exce.Worksheets(0).Cells
cells("A1").PutValue("Helloworld")
cells("A1").Characters(5, 5).Font.IsBold = True
cells("A1").Characters(5, 5).Font.Color = Color.Blue
Observaciones
Este método solo funciona en celdas con valor de cadena.
Copy(Cell)
Copia datos de una celda fuente.
public void Copy(Cell cell)
Parámetros
cell
Cell
Objeto Aspose.Cells.Cell fuente.
Equals(object)
Verifica si este objeto se refiere a la misma celda que otro.
public override bool Equals(object obj)
Parámetros
obj
object
otro objeto
Devuelve
true si dos objetos se refieren a la misma celda.
Equals(Cell)
Verifica si este objeto se refiere a la misma celda que otro objeto celda.
public bool Equals(Cell cell)
Parámetros
cell
Cell
otro objeto celda
Devuelve
true si dos objetos celda se refieren a la misma celda.
GetArrayRange()
Obtiene el rango de matriz si la fórmula de la celda es una fórmula de matriz.
public CellArea GetArrayRange()
Devuelve
El rango de matriz.
Observaciones
Solo se aplica cuando 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.
public FontSetting[] GetCharacters()
Devuelve
Todos los objetos Characters.
GetCharacters(bool)
Devuelve todos los objetos Characters que representan un rango de caracteres dentro del texto de la celda.
public FontSetting[] GetCharacters(bool flag)
Parámetros
flag
bool
Indica si se aplica estilo de tabla a la celda si la celda está en la tabla.
Devuelve
Todos los objetos Characters.
GetConditionalFormattingResult()
Obtiene el resultado del formato condicional.
public ConditionalFormattingResult GetConditionalFormattingResult()
Devuelve
Observaciones
Devuelve null si no se aplica formato condicional a esta celda.
GetDependents(bool)
Obtiene todas las celdas cuya fórmula hace referencia a esta celda directamente.
public Cell[] GetDependents(bool isAll)
Parámetros
isAll
bool
Indica si se verifica fórmulas en otras hojas de trabajo.
Devuelve
Cell[]
Ejemplos
Workbook workbook = new Workbook();
Cells cells = workbook.Worksheets[0].Cells;
cells["A1"].Formula = "=B1+SUM(B1:B10)+[Book1.xls]Sheet1!B2";
cells["A2"].Formula = "=IF(TRUE,B2,B1)";
Cell[] dependents = cells["B1"].GetDependents(true);
for (int i = 0; i < dependents.Length; i++)
{
Console.WriteLine(dependents[i].Name);
}
Observaciones
- Si una referencia que contiene esta celda aparece en la fórmula de una celda, esa celda se considerará como dependiente de esta celda, sin importar si la referencia o esta celda se utiliza o no al calcular. Por ejemplo, aunque la celda A2 en la fórmula "=IF(TRUE,A1,A2)" no se utiliza al calcular, esta fórmula aún se considera como dependiente de A2.
- Para obtener aquellas fórmulas cuyos resultados calculados dependen de esta celda, utilice Aspose.Cells.Cell.GetDependentsInCalculation(System.Boolean).
- Al rastrear dependientes para una celda, se analizarán y comprobarán todas las fórmulas en el libro de trabajo o en la hoja de trabajo. Por lo tanto, es un proceso que consume tiempo. Si el usuario necesita rastrear dependientes para muchas celdas, usar este método puede causar un bajo rendimiento. Por consideraciones de rendimiento, el usuario debe usar Aspose.Cells.Cell.GetDependentsInCalculation(System.Boolean) en su lugar. O, el usuario puede recopilar el mapa de precedentes de todas las celdas utilizando Aspose.Cells.Cell.GetPrecedents primero y luego construir el mapa de dependientes según el mapa de precedentes.
GetDependentsInCalculation(bool)
Obtiene todas las celdas cuyo resultado calculado depende de esta celda.
public IEnumerator GetDependentsInCalculation(bool recursive)
Parámetros
recursive
bool
Si devuelve aquellos dependientes que no hacen referencia a esta celda directamente pero hacen referencia a otros elementos de esta celda.
Devuelve
Enumerador para enumerar todos los dependientes (objetos Cell).
Ejemplos
Workbook workbook = new Workbook();
Cells cells = workbook.Worksheets[0].Cells;
cells["A1"].Formula = "=B1+SUM(B1:B10)+[Book1.xls]Sheet1!B2";
cells["A2"].Formula = "=IF(TRUE,B2,B1)";
workbook.Settings.FormulaSettings.EnableCalculationChain = true;
workbook.CalculateFormula();
IEnumerator en = cells["B1"].GetDependentsInCalculation(false);
Console.WriteLine("Dependientes de cálculo de B1:");
while(en.MoveNext())
{
Cell c = (Cell)en.Current;
Console.WriteLine(c.Name);
}
en = cells["B2"].GetDependentsInCalculation(false);
Console.WriteLine("Dependientes de cálculo de B2:");
while(en.MoveNext())
{
Cell c = (Cell)en.Current;
Console.WriteLine(c.Name);
}
Observaciones
Para utilizar este método, asegúrese de que el libro de trabajo se haya configurado con un valor verdadero para Aspose.Cells.FormulaSettings.EnableCalculationChain y se haya calculado completamente con esta configuración. Si no hay referencia de fórmula a esta celda, se devolverá null.
GetDisplayStyle()
Obtiene el estilo de visualización de la celda. Si esta celda también se ve afectada por otras configuraciones como formato condicional, objetos de lista, etc., entonces el estilo de visualización puede ser diferente de cell.GetStyle().
public Style GetDisplayStyle()
Devuelve
GetDisplayStyle(bool)
Obtiene el estilo de visualización de la celda. Si la celda está formateada condicionalmente, el estilo de visualización no es el mismo que cell.GetStyle().
public Style GetDisplayStyle(bool includeMergedBorders)
Parámetros
includeMergedBorders
bool
Indica si se verifican los bordes de las celdas combinadas.
Devuelve
GetFormatConditions()
Obtiene las condiciones de formato que se aplican a esta celda.
public FormatConditionCollection[] GetFormatConditions()
Devuelve
Devuelve el objeto Aspose.Cells.FormatConditionCollection.
GetFormula(bool, bool)
Obtiene la fórmula de esta celda.
public string GetFormula(bool isR1C1, bool isLocal)
Parámetros
isR1C1
bool
Si la fórmula necesita ser formateada como R1C1.
isLocal
bool
Si la fórmula necesita ser formateada por localidad.
Devuelve
la fórmula de esta celda.
GetHashCode()
Sirve como una función hash para un tipo particular.
public override int GetHashCode()
Devuelve
Un código hash para el objeto Cell actual.
GetHeightOfValue()
Obtiene la altura del valor en unidades de píxeles.
public int GetHeightOfValue()
Devuelve
GetHtmlString(bool)
Obtiene la cadena html que contiene datos y algunos formatos en esta celda.
public string GetHtmlString(bool html5)
Parámetros
html5
bool
Indica si el valor es compatible con html5.
Devuelve
GetMergedRange()
Devuelve un objeto Aspose.Cells.Range que representa un rango combinado.
public Range GetMergedRange()
Devuelve
Objeto Aspose.Cells.Range. Null si esta celda no está combinada.
GetPrecedents()
Obtiene todas las referencias que aparecen en la fórmula de esta celda.
public ReferredAreaCollection GetPrecedents()
Devuelve
Colección de todas las referencias que aparecen en la fórmula de esta celda.
Ejemplos
Workbook workbook = new Workbook();
Cells cells = workbook.Worksheets[0].Cells;
cells["A1"].Formula = "=B1+SUM(B1:B10)+[Book1.xls]Sheet1!A1";
ReferredAreaCollection areas = cells["A1"].GetPrecedents();
for (int i = 0; i < areas.Count; i++)
{
ReferredArea area = areas[i];
StringBuilder stringBuilder = new StringBuilder();
if (area.IsExternalLink)
{
stringBuilder.Append("[");
stringBuilder.Append(area.ExternalFileName);
stringBuilder.Append("]");
}
stringBuilder.Append(area.SheetName);
stringBuilder.Append("!");
stringBuilder.Append(CellsHelper.CellIndexToName(area.StartRow, area.StartColumn));
if (area.IsArea)
{
stringBuilder.Append(":");
stringBuilder.Append(CellsHelper.CellIndexToName(area.EndRow, area.EndColumn));
}
Console.WriteLine(stringBuilder.ToString());
}
Dim workbook As Workbook = New Workbook()
Dim cells As Cells = workbook.Worksheets(0).Cells
cells("A1").Formula = "= B1 + SUM(B1:B10) + [Book1.xls]Sheet1!A1"
Dim areas As ReferredAreaCollection = cells("A1").GetPrecedents()
For i As Integer = 0 To areas.Count - 1
Dim area As ReferredArea = areas(i)
Dim stringBuilder As StringBuilder = New StringBuilder()
If (area.IsExternalLink) Then
stringBuilder.Append("[")
stringBuilder.Append(area.ExternalFileName)
stringBuilder.Append("]")
End If
stringBuilder.Append(area.SheetName)
stringBuilder.Append("!")
stringBuilder.Append(CellsHelper.CellIndexToName(area.StartRow, area.StartColumn))
If (area.IsArea) Then
stringBuilder.Append(":")
stringBuilder.Append(CellsHelper.CellIndexToName(area.EndRow, area.EndColumn))
End If
Console.WriteLine(stringBuilder.ToString())
Next
Observaciones
- Devuelve null si esta no es una celda de fórmula.
- Todas las referencias que aparecen en la fórmula de esta celda se devolverán sin importar si se utilizan o no al calcular. Por ejemplo, aunque la celda A2 en la fórmula "=IF(TRUE,A1,A2)" no se utiliza al calcular, aún se considera como precedentes de la fórmula.
- Para obtener aquellas referencias que influyen solo en el cálculo, utilice Aspose.Cells.Cell.GetPrecedentsInCalculation.
GetPrecedentsInCalculation()
Obtiene todos los precedentes (referencias a celdas en el libro de trabajo actual) utilizados por la fórmula de esta celda al calcularla.
public IEnumerator GetPrecedentsInCalculation()
Devuelve
Enumerador para enumerar todas las referencias (ReferredArea).
Ejemplos
Workbook workbook = new Workbook();
Cells cells = workbook.Worksheets[0].Cells;
cells["A2"].Formula = "=IF(TRUE,B2,B1)";
workbook.Settings.FormulaSettings.EnableCalculationChain = true;
workbook.CalculateFormula();
IEnumerator en = cells["A2"].GetPrecedentsInCalculation();
Console.WriteLine("Precedentes de cálculo de A2:");
while(en.MoveNext())
{
ReferredArea r = (ReferredArea)en.Current;
Console.WriteLine(r);
}
Observaciones
Este método solo puede funcionar con la situación en la que Aspose.Cells.FormulaSettings.EnableCalculationChain es verdadero para el libro de trabajo y el libro de trabajo se ha calculado completamente. Si esta celda no es una fórmula o no hace referencia a otras celdas, se devolverá null.
GetRichValue()
Obtiene el valor enriquecido de la celda.
public CellRichValue GetRichValue()
Devuelve
GetStringValue(CellValueFormatStrategy)
Obtiene el valor de cadena mediante una estrategia de formato específica.
public string GetStringValue(CellValueFormatStrategy formatStrategy)
Parámetros
formatStrategy
CellValueFormatStrategy
La estrategia de formato.
Devuelve
GetStyle()
Obtiene el estilo de la celda.
public Style GetStyle()
Devuelve
Objeto de estilo.
Observaciones
Para cambiar el estilo de la celda, llame al método Cell.SetStyle() después de modificar el objeto de estilo devuelto. Este método es el mismo que Aspose.Cells.Cell.GetStyle(System.Boolean) con valor verdadero para el parámetro.
GetStyle(bool)
Si checkBorders es verdadero, verifica si los bordes de otras celdas afectarán el estilo de esta celda.
public Style GetStyle(bool checkBorders)
Parámetros
checkBorders
bool
Verifica los bordes de otras celdas.
Devuelve
Objeto de estilo.
GetTable()
Obtiene la tabla que contiene esta celda.
public ListObject GetTable()
Devuelve
GetValidation()
Obtiene la validación aplicada a esta celda.
public Validation GetValidation()
Devuelve
GetValidationValue()
Obtiene el valor de validación que se aplica a esta celda.
public bool GetValidationValue()
Devuelve
GetWidthOfValue()
Obtiene el ancho del valor en unidades de píxeles.
public int GetWidthOfValue()
Devuelve
InsertText(int, string)
Inserta algunos caracteres en la celda. Si la celda está formateada en rico, este método puede mantener el formato original.
public void InsertText(int index, string text)
Parámetros
index
int
El índice.
text
string
Texto insertado.
IsRichText()
Indica si el valor de cadena de esta celda es un texto formateado en rico.
public bool IsRichText()
Devuelve
PutValue(bool)
Coloca un valor booleano en la celda.
public void PutValue(bool boolValue)
Parámetros
boolValue
bool
PutValue(int)
Coloca un valor entero en la celda.
public void PutValue(int intValue)
Parámetros
intValue
int
Valor de entrada.
PutValue(double)
Coloca un valor doble en la celda.
public void PutValue(double doubleValue)
Parámetros
doubleValue
double
Valor de entrada.
PutValue(string, bool, bool)
Coloca un valor en la celda, si es apropiado, el valor se convertirá a otro tipo de dato y se restablecerá el formato numérico de la celda.
public void PutValue(string stringValue, bool isConverted, bool setStyle)
Parámetros
stringValue
string
Valor de entrada.
isConverted
bool
Verdadero: convertido a otro tipo de dato si es apropiado.
setStyle
bool
Verdadero: establece el formato numérico en el estilo de la celda al convertir a otro tipo de dato.
PutValue(string, bool)
Coloca un valor de cadena en la celda y convierte el valor a otro tipo de dato si es apropiado.
public void PutValue(string stringValue, bool isConverted)
Parámetros
stringValue
string
Valor de entrada.
isConverted
bool
Verdadero: convertido a otro tipo de dato si es apropiado.
PutValue(string)
Coloca un valor de cadena en la celda.
public void PutValue(string stringValue)
Parámetros
stringValue
string
Valor de entrada.
PutValue(DateTime)
Coloca un valor DateTime en la celda.
public void PutValue(DateTime dateTime)
Parámetros
dateTime
DateTime
Valor de entrada.
Ejemplos
Este ejemplo muestra cómo establecer un valor DateTime en una celda y hacer que se muestre como fecha y hora.
Workbook excel = new Workbook();
Cells cells = excel.Worksheets[0].Cells;
//Colocar fecha y hora en una celda
Cell cell = cells[0, 0];
cell.PutValue(new DateTime(2023, 5, 15));
Style style = cell.GetStyle(false);
style.Number = 14;
cell.SetStyle(style);
Observaciones
Establecer un valor DateTime para una celda no significa que la celda se formateará automáticamente como fecha y hora. El valor DateTime se mantiene como valor numérico en el modelo de datos tanto de ms excel como de Aspose.Cells. Si el valor numérico se tomará como valor numérico o fecha y hora depende del formato numérico aplicado a esta celda. Si esta celda no se ha formateado como fecha y hora, se mostrará como un valor numérico incluso si lo que se ingresó es DateTime.
PutValue(object)
Coloca un valor de objeto en la celda.
public void PutValue(object objectValue)
Parámetros
objectValue
object
valor de entrada.
RemoveArrayFormula(bool)
Elimina la fórmula de matriz.
public void RemoveArrayFormula(bool leaveNormalFormula)
Parámetros
leaveNormalFormula
bool
Verdadero representa convertir la fórmula de matriz a fórmula normal.
Replace(string, string, ReplaceOptions)
Reemplaza el texto de la celda con opciones.
public void Replace(string placeHolder, string newValue, ReplaceOptions options)
Parámetros
placeHolder
string
Marcador de posición de la celda.
newValue
string
Valor de cadena para reemplazar.
options
ReplaceOptions
Las opciones de reemplazo.
SetArrayFormula(string, int, int)
Establece una fórmula de matriz (fórmula de matriz heredada ingresada a través de CTRL+SHIFT+ENTER en ms excel) en un rango de celdas.
public void SetArrayFormula(string arrayFormula, int rowNumber, int columnNumber)
Parámetros
arrayFormula
string
Fórmula de matriz.
rowNumber
int
Número de filas para poblar el resultado de la fórmula de matriz.
columnNumber
int
Número de columnas para poblar el resultado de la fórmula de matriz.
SetArrayFormula(string, int, int, FormulaParseOptions)
Establece una fórmula de matriz en un rango de celdas.
public void SetArrayFormula(string arrayFormula, int rowNumber, int columnNumber, FormulaParseOptions options)
Parámetros
arrayFormula
string
Fórmula de matriz.
rowNumber
int
Número de filas para poblar el resultado de la fórmula de matriz.
columnNumber
int
Número de columnas para poblar el resultado de la fórmula de matriz.
options
FormulaParseOptions
Opciones para analizar la fórmula.
SetArrayFormula(string, int, int, FormulaParseOptions, object[][])
Establece una fórmula de matriz en un rango de celdas.
public void SetArrayFormula(string arrayFormula, int rowNumber, int columnNumber, FormulaParseOptions options, object[][] values)
Parámetros
arrayFormula
string
Fórmula de matriz.
rowNumber
int
Número de filas para poblar el resultado de la fórmula de matriz.
columnNumber
int
Número de columnas para poblar el resultado de la fórmula de matriz.
options
FormulaParseOptions
Opciones para analizar la fórmula.
values
object[][]
valores para aquellas celdas con la fórmula de matriz dada.
SetCharacters(FontSetting[])
Establece el formato de texto enriquecido de la celda.
public void SetCharacters(FontSetting[] characters)
Parámetros
characters
FontSetting[]
Todos los objetos Characters.
SetDynamicArrayFormula(string, FormulaParseOptions, bool)
Establece una fórmula de matriz dinámica y hace que la fórmula se derrame en celdas vecinas si es posible.
public CellArea SetDynamicArrayFormula(string arrayFormula, FormulaParseOptions options, bool calculateValue)
Parámetros
arrayFormula
string
la expresión de fórmula.
options
FormulaParseOptions
opciones para analizar la fórmula. La opción “Parse” se ignorará y la fórmula siempre se analizará de inmediato.
calculateValue
bool
si calcular este valor de fórmula de matriz dinámica para aquellas celdas en el rango derramado.
Devuelve
el rango en el que la fórmula debería derramarse.
Observaciones
el rango devuelto puede no ser el mismo que el real en el que esta fórmula de matriz dinámica se derrama. Si hay celdas no vacías en el rango, la fórmula se establecerá solo para la celda actual y se marcará como “#SPILL!”. Pero para tal situación, aún devolvemos el rango completo en el que esta fórmula debería derramarse.
SetDynamicArrayFormula(string, FormulaParseOptions, object[][], bool, bool)
Establece una fórmula de matriz dinámica y hace que la fórmula se derrame en celdas vecinas si es posible.
public CellArea SetDynamicArrayFormula(string arrayFormula, FormulaParseOptions options, object[][] values, bool calculateRange, bool calculateValue)
Parámetros
arrayFormula
string
la expresión de fórmula.
options
FormulaParseOptions
opciones para analizar la fórmula. La opción “Parse” se ignorará y la fórmula siempre se analizará de inmediato.
values
object[][]
valores (resultados calculados) para aquellas celdas con la fórmula de matriz dinámica dada.
calculateRange
bool
Si calcular el rango derramado para esta fórmula de matriz dinámica. Si el parámetro “values” no es nulo y esta bandera es falsa, entonces la altura del rango derramado será values.Length y el ancho será values[0].Length.
calculateValue
bool
si calcular esta fórmula de matriz dinámica para aquellas celdas en el rango derramado cuando “values” es nulo o el ítem correspondiente en “values” para una celda es nulo.
Devuelve
el rango en el que la fórmula debería derramarse.
Observaciones
el rango devuelto puede no ser el mismo que el real en el que esta fórmula de matriz dinámica se derrama. Si hay celdas no vacías en el rango, la fórmula se establecerá solo para la celda actual y se marcará como “#SPILL!”. Pero para tal situación, aún devolvemos el rango completo en el que esta fórmula debería derramarse.
SetDynamicArrayFormula(string, FormulaParseOptions, object[][], bool, bool, CalculationOptions)
Establece una fórmula de matriz dinámica y hace que la fórmula se derrame en celdas vecinas si es posible.
public CellArea SetDynamicArrayFormula(string arrayFormula, FormulaParseOptions options, object[][] values, bool calculateRange, bool calculateValue, CalculationOptions copts)
Parámetros
arrayFormula
string
la expresión de fórmula.
options
FormulaParseOptions
opciones para analizar la fórmula. La opción “Parse” se ignorará y la fórmula siempre se analizará de inmediato.
values
object[][]
valores (resultados calculados) para aquellas celdas con la fórmula de matriz dinámica dada.
calculateRange
bool
Si calcular el rango derramado para esta fórmula de matriz dinámica. Si el parámetro “values” no es nulo y esta bandera es falsa, entonces la altura del rango derramado será values.Length y el ancho será values[0].Length.
calculateValue
bool
si calcular esta fórmula de matriz dinámica para aquellas celdas en el rango derramado cuando “values” es nulo o el ítem correspondiente en “values” para una celda es nulo.
copts
CalculationOptions
Las opciones para calcular la fórmula. Comúnmente, por consideraciones de rendimiento, la propiedad Aspose.Cells.CalculationOptions.Recursive debe ser falsa.
Devuelve
el rango en el que la fórmula debería derramarse.
Observaciones
el rango devuelto puede no ser el mismo que el real en el que esta fórmula de matriz dinámica se derrama. Si hay celdas no vacías en el rango, la fórmula se establecerá solo para la celda actual y se marcará como “#SPILL!”. Pero para tal situación, aún devolvemos el rango completo en el que esta fórmula debería derramarse.
SetFormula(string, object)
Establece la fórmula y el valor (resultado calculado) de la fórmula.
public void SetFormula(string formula, object value)
Parámetros
formula
string
La fórmula.
value
object
El valor (resultado calculado) de la fórmula.
SetFormula(string, FormulaParseOptions)
Establece la fórmula y el valor (resultado calculado) de la fórmula.
public void SetFormula(string formula, FormulaParseOptions options)
Parámetros
formula
string
La fórmula.
options
FormulaParseOptions
Opciones para analizar la fórmula.
SetFormula(string, FormulaParseOptions, object)
Establece la fórmula y el valor (resultado calculado) de la fórmula.
public void SetFormula(string formula, FormulaParseOptions options, object value)
Parámetros
formula
string
La fórmula.
options
FormulaParseOptions
Opciones para analizar la fórmula.
value
object
El valor (resultado calculado) de la fórmula.
SetSharedFormula(string, int, int)
Establece fórmulas compartidas en un rango de celdas.
public void SetSharedFormula(string sharedFormula, int rowNumber, int columnNumber)
Parámetros
sharedFormula
string
Fórmula compartida.
rowNumber
int
Número de filas para poblar la fórmula.
columnNumber
int
Número de columnas para poblar la fórmula.
SetSharedFormula(string, int, int, FormulaParseOptions)
Establece fórmulas compartidas en un rango de celdas.
public void SetSharedFormula(string sharedFormula, int rowNumber, int columnNumber, FormulaParseOptions options)
Parámetros
sharedFormula
string
Fórmula compartida.
rowNumber
int
Número de filas para poblar la fórmula.
columnNumber
int
Número de columnas para poblar la fórmula.
options
FormulaParseOptions
Opciones para analizar la fórmula.
SetSharedFormula(string, int, int, FormulaParseOptions, object[][])
Establece fórmulas compartidas en un rango de celdas.
public void SetSharedFormula(string sharedFormula, int rowNumber, int columnNumber, FormulaParseOptions options, object[][] values)
Parámetros
sharedFormula
string
Fórmula compartida.
rowNumber
int
Número de filas para poblar la fórmula.
columnNumber
int
Número de columnas para poblar la fórmula.
options
FormulaParseOptions
Opciones para analizar la fórmula.
values
object[][]
valores para aquellas celdas con la fórmula compartida dada.
SetStyle(Style)
Establece el estilo de la celda.
public void SetStyle(Style style)
Parámetros
style
Style
El estilo de la celda.
Observaciones
Si se cambian las configuraciones de borde, el borde de las celdas ajustadas también se actualizará.
SetStyle(Style, bool)
Aplica la propiedad cambiada del estilo a la celda.
public void SetStyle(Style style, bool explicitFlag)
Parámetros
style
Style
El estilo de la celda.
explicitFlag
bool
Verdadero, solo sobrescribe el formato que se establece explícitamente.
SetStyle(Style, StyleFlag)
Aplica el estilo de la celda según las banderas.
public void SetStyle(Style style, StyleFlag flag)
Parámetros
style
Style
El estilo de la celda.
flag
StyleFlag
La bandera de estilo.
SetTableFormula(int, int, string, string, object[][])
Crea una tabla de datos de dos variables para el rango dado que comienza desde esta celda.
public void SetTableFormula(int rowNumber, int columnNumber, string rowInputCell, string columnInputCell, object[][] values)
Parámetros
rowNumber
int
Número de filas para poblar la fórmula.
columnNumber
int
Número de columnas para poblar la fórmula.
rowInputCell
string
la celda de entrada de fila.
columnInputCell
string
la celda de entrada de columna.
values
object[][]
valores para las celdas en el rango de fórmula de tabla.
SetTableFormula(int, int, string, bool, object[][])
Crea una tabla de datos de una variable para el rango dado que comienza desde esta celda.
public void SetTableFormula(int rowNumber, int columnNumber, string inputCell, bool isRowInput, object[][] values)
Parámetros
rowNumber
int
Número de filas para poblar la fórmula.
columnNumber
int
Número de columnas para poblar la fórmula.
inputCell
string
la celda de entrada.
isRowInput
bool
Indica si la celda de entrada es una celda de entrada de fila (verdadero) o una celda de entrada de columna (falso).
values
object[][]
valores para las celdas en el rango de fórmula de tabla.
SetTableFormula(int, int, int, int, int, int, object[][])
Crea una tabla de datos de dos variables para el rango dado que comienza desde esta celda.
public void SetTableFormula(int rowNumber, int columnNumber, int rowIndexOfRowInputCell, int columnIndexOfRowInputCell, int rowIndexOfColumnInputCell, int columnIndexOfColumnInputCell, object[][] values)
Parámetros
rowNumber
int
Número de filas para poblar la fórmula.
columnNumber
int
Número de columnas para poblar la fórmula.
rowIndexOfRowInputCell
int
índice de fila de la celda de entrada de fila.
columnIndexOfRowInputCell
int
índice de columna de la celda de entrada de fila.
rowIndexOfColumnInputCell
int
índice de fila de la celda de entrada de columna.
columnIndexOfColumnInputCell
int
índice de columna de la celda de entrada de columna.
values
object[][]
valores para las celdas en el rango de fórmula de tabla.
SetTableFormula(int, int, int, int, bool, object[][])
Crea una tabla de datos de una variable para el rango dado que comienza desde esta celda.
public void SetTableFormula(int rowNumber, int columnNumber, int rowIndexOfInputCell, int columnIndexOfInputCell, bool isRowInput, object[][] values)
Parámetros
rowNumber
int
Número de filas para poblar la fórmula.
columnNumber
int
Número de columnas para poblar la fórmula.
rowIndexOfInputCell
int
índice de fila de la celda de entrada.
columnIndexOfInputCell
int
índice de columna de la celda de entrada.
isRowInput
bool
Indica si la celda de entrada es una celda de entrada de fila (verdadero) o una celda de entrada de columna (falso).
values
object[][]
valores para las celdas en el rango de fórmula de tabla.
ToJson()
Convierte Aspose.Cells.Cell a datos estructurados JSON.
public string ToJson()
Devuelve
ToString()
Devuelve una cadena que representa el objeto Cell actual.
public override string ToString()