Class Cell

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

objectCell

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

bool

Column

Obtiene el número de columna (basado en cero) de la celda.

public int Column { get; }

Valor de la propiedad

int

Comment

Obtiene el comentario de esta celda.

public Comment Comment { get; }

Valor de la propiedad

Comment

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

bool

DateTimeValue

Obtiene el valor DateTime contenido en la celda.

public DateTime DateTimeValue { get; }

Valor de la propiedad

DateTime

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

string

DoubleValue

Obtiene el valor doble contenido en la celda.

public double DoubleValue { get; }

Valor de la propiedad

double

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

float

Formula

Obtiene o establece una fórmula de la Aspose.Cells.Cell.

public string Formula { get; set; }

Valor de la propiedad

string

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

string

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

bool

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

string

IntValue

Obtiene el valor entero contenido en la celda.

public int IntValue { get; }

Valor de la propiedad

int

IsArrayFormula

Indica si la fórmula de la celda es una fórmula de matriz.

public bool IsArrayFormula { get; }

Valor de la propiedad

bool

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

bool

IsCheckBoxStyle

Indica si se establece esta celda como una casilla de verificación.

public bool IsCheckBoxStyle { get; set; }

Valor de la propiedad

bool

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

bool

IsErrorValue

Verifica si el valor de esta celda es un error.

public bool IsErrorValue { get; }

Valor de la propiedad

bool

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

bool

IsMerged

Verifica si una celda es parte de un rango combinado o no.

public bool IsMerged { get; }

Valor de la propiedad

bool

IsNumericValue

Indica si el valor de esta celda es numérico (int, double y datetime).

public bool IsNumericValue { get; }

Valor de la propiedad

bool

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

bool

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

bool

IsTableFormula

Indica si esta celda es parte de una fórmula de tabla.

public bool IsTableFormula { get; }

Valor de la propiedad

bool

Name

Obtiene el nombre de la celda.

public string Name { get; }

Valor de la propiedad

string

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

NumberCategoryType

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

string

Row

Obtiene el número de fila (basado en cero) de la celda.

public int Row { get; }

Valor de la propiedad

int

SharedStyleIndex

Obtiene el índice de estilo compartido de la celda en el grupo de estilos.

public int SharedStyleIndex { get; }

Valor de la propiedad

int

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

string

Type

Representa el tipo de valor de la celda.

public CellValueType Type { get; }

Valor de la propiedad

CellValueType

Value

Obtiene/establece el valor contenido en esta celda.

public object Value { get; set; }

Valor de la propiedad

object

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

Worksheet

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

FontSetting

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

bool

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

bool

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

CellArea

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

FontSetting[]

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

FontSetting[]

Todos los objetos Characters.

GetConditionalFormattingResult()

Obtiene el resultado del formato condicional.

public ConditionalFormattingResult GetConditionalFormattingResult()

Devuelve

ConditionalFormattingResult

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

IEnumerator

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

Style

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

Style

GetFormatConditions()

Obtiene las condiciones de formato que se aplican a esta celda.

public FormatConditionCollection[] GetFormatConditions()

Devuelve

FormatConditionCollection[]

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

string

la fórmula de esta celda.

GetHashCode()

Sirve como una función hash para un tipo particular.

public override int GetHashCode()

Devuelve

int

Un código hash para el objeto Cell actual.

GetHeightOfValue()

Obtiene la altura del valor en unidades de píxeles.

public int GetHeightOfValue()

Devuelve

int

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

string

GetMergedRange()

Devuelve un objeto Aspose.Cells.Range que representa un rango combinado.

public Range GetMergedRange()

Devuelve

Range

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

ReferredAreaCollection

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

IEnumerator

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

CellRichValue

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

string

GetStyle()

Obtiene el estilo de la celda.

public Style GetStyle()

Devuelve

Style

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

Style

Objeto de estilo.

GetTable()

Obtiene la tabla que contiene esta celda.

public ListObject GetTable()

Devuelve

ListObject

GetValidation()

Obtiene la validación aplicada a esta celda.

public Validation GetValidation()

Devuelve

Validation

GetValidationValue()

Obtiene el valor de validación que se aplica a esta celda.

public bool GetValidationValue()

Devuelve

bool

GetWidthOfValue()

Obtiene el ancho del valor en unidades de píxeles.

public int GetWidthOfValue()

Devuelve

int

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

bool

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

CellArea

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

CellArea

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

CellArea

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

string

ToString()

Devuelve una cadena que representa el objeto Cell actual.

public override string ToString()

Devuelve

string

 Español