Class Cell

Class Cell

Namespace: Aspose.Cells
Assembly: Aspose.Cells.dll (25.2.0)

Encapsula o objeto que representa uma única célula do Workbook.

public class Cell

Herança

objectCell

Membros Herdados

object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

Exemplos

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

//Colocar uma string em uma célula
Cell cell = cells[0, 0];
cell.PutValue("Olá");

string first = cell.StringValue;

//Colocar um inteiro em uma célula
cell = cells["B1"];
cell.PutValue(12);

int second = cell.IntValue;

//Colocar um double em uma célula
cell = cells[0, 2];
cell.PutValue(-1.234);

double third = cell.DoubleValue;

//Colocar uma fórmula em uma célula
cell = cells["D1"];
cell.Formula = "=B1 + C1";

//Colocar uma fórmula combinada: "soma(média(b1,c1), b1)" na célula b2
cell = cells["b2"];
cell.Formula = "=soma(média(b1,c1), b1)";

//Definir estilo de uma célula
Style style = cell.GetStyle();
//Definir cor de fundo
style.BackgroundColor = Color.Yellow;
//Definir formato de uma célula
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 uma string em uma célula
Dim cell as Cell = cells(0, 0)
cell.PutValue("Olá")

Dim first as String = cell.StringValue

//Colocar um inteiro em uma célula
cell = cells("B1")
cell.PutValue(12)

Dim second as Integer = cell.IntValue

//Colocar um double em uma célula
cell = cells(0, 2)
cell.PutValue(-1.234)

Dim third as Double = cell.DoubleValue

//Colocar uma fórmula em uma célula
cell = cells("D1")
cell.Formula = "=B1 + C1"

//Colocar uma fórmula combinada: "soma(média(b1,c1), b1)" na célula b2
cell = cells("b2")
cell.Formula = "=soma(média(b1,c1), b1)"

//Definir estilo de uma célula
Dim style as Style = cell.GetStyle()

//Definir cor de fundo
style.BackgroundColor = Color.Yellow
//Definir fonte de uma célula
style.Font.Name = "Courier New"
style.VerticalAlignment = TextAlignmentType.Top
cell.SetStyle(style)

Propriedades

BoolValue

Obtém o valor booleano contido na célula.

public bool BoolValue { get; }

Valor da Propriedade

bool

Column

Obtém o número da coluna (base zero) da célula.

public int Column { get; }

Valor da Propriedade

int

Comment

Obtém o comentário desta célula.

public Comment Comment { get; }

Valor da Propriedade

Comment

Observações

Se não houver comentário aplicável à célula, retorna null.

ContainsExternalLink

Indica se esta célula contém um link externo. Aplica-se somente quando a célula é uma célula de fórmula.

public bool ContainsExternalLink { get; }

Valor da Propriedade

bool

DateTimeValue

Obtém o valor DateTime contido na célula.

public DateTime DateTimeValue { get; }

Valor da Propriedade

DateTime

DisplayStringValue

Obtém o valor da string formatada desta célula pelo estilo de exibição da célula.

public string DisplayStringValue { get; }

Valor da Propriedade

string

DoubleValue

Obtém o valor double contido na célula.

public double DoubleValue { get; }

Valor da Propriedade

double

EmbeddedImage

Obtém e define a imagem incorporada na célula.

public byte[] EmbeddedImage { get; set; }

Valor da Propriedade

byte[]

FloatValue

Obtém o valor float contido na célula.

public float FloatValue { get; }

Valor da Propriedade

float

Formula

Obtém ou define uma fórmula da Aspose.Cells.Cell.

public string Formula { get; set; }

Valor da Propriedade

string

Exemplos

Workbook excel = new Workbook();
Cells cells = excel.Worksheets[0].Cells;
cells["B6"].Formula = "=SOMA(B2:B5, E1) + sheet1!A1";
Dim excel As Workbook =  New Workbook() 
Dim cells As Cells =  excel.Worksheets(0).Cells 
cells("B6").Formula = "=SOMA(B2:B5, E1) + sheet1!A1"

Observações

Uma string de fórmula sempre começa com um sinal de igual (=). E por favor, sempre use vírgula (,) como delimitador de parâmetros, como “=SOMA(A1, E1, H2)”.

FormulaLocal

Obtém a fórmula formatada para o local da célula.

public string FormulaLocal { get; set; }

Valor da Propriedade

string

HasCustomStyle

Indica se esta célula possui configurações de estilo personalizadas (diferentes do padrão herdado da linha, coluna ou workbook correspondente).

public bool HasCustomStyle { get; }

Valor da Propriedade

bool

HtmlString

Obtém e define a string HTML que contém dados e alguns formatos nesta célula.

public string HtmlString { get; set; }

Valor da Propriedade

string

IntValue

Obtém o valor inteiro contido na célula.

public int IntValue { get; }

Valor da Propriedade

int

IsArrayFormula

Indica se a fórmula da célula é uma fórmula de matriz.

public bool IsArrayFormula { get; }

Valor da Propriedade

bool

IsArrayHeader

Indica se a fórmula da célula é uma fórmula de matriz e se é a primeira célula da matriz.

public bool IsArrayHeader { get; }

Valor da Propriedade

bool

IsCheckBoxStyle

Indica se a célula está definida como uma caixa de seleção.

public bool IsCheckBoxStyle { get; set; }

Valor da Propriedade

bool

IsDynamicArrayFormula

Indica se a fórmula da célula é uma fórmula de matriz dinâmica (true) ou fórmula de matriz legada (false).

public bool IsDynamicArrayFormula { get; }

Valor da Propriedade

bool

IsErrorValue

Verifica se o valor desta célula é um erro.

public bool IsErrorValue { get; }

Valor da Propriedade

bool

Observações

Aplica-se também à célula de fórmula para verificar se o resultado calculado é um erro.

IsFormula

Representa se a célula especificada contém uma fórmula.

public bool IsFormula { get; }

Valor da Propriedade

bool

IsMerged

Verifica se uma célula faz parte de um intervalo mesclado ou não.

public bool IsMerged { get; }

Valor da Propriedade

bool

IsNumericValue

Indica se o valor desta célula é numérico (int, double e datetime).

public bool IsNumericValue { get; }

Valor da Propriedade

bool

Observações

Aplica-se também à célula de fórmula para verificar o resultado calculado.

IsSharedFormula

Indica se a fórmula da célula é parte de uma fórmula compartilhada.

public bool IsSharedFormula { get; }

Valor da Propriedade

bool

IsStyleSet

Indica se o estilo da célula está definido. Se retornar false, significa que esta célula possui um formato de célula padrão.

public bool IsStyleSet { get; }

Valor da Propriedade

bool

IsTableFormula

Indica se esta célula faz parte de uma fórmula de tabela.

public bool IsTableFormula { get; }

Valor da Propriedade

bool

Name

Obtém o nome da célula.

public string Name { get; }

Valor da Propriedade

string

Observações

Um nome de célula inclui a letra da coluna e o número da linha. Por exemplo, o nome de uma célula na linha 0 e coluna 0 é A1.

NumberCategoryType

Representa o tipo de categoria da formatação numérica desta célula.

public NumberCategoryType NumberCategoryType { get; }

Valor da Propriedade

NumberCategoryType

Observações

Quando o padrão de formatação da célula é combinado com padrões de formatação condicional, então o tipo retornado corresponde à parte que é usada para o valor atual desta célula. Por exemplo, se o padrão de formatação para esta célula é “#,##0;(#,##0);”-";@", então quando o valor da célula é numérico e não 0, o tipo retornado é Aspose.Cells.NumberCategoryType.Number; Quando o valor da célula é 0 ou não é um valor numérico, o tipo retornado é Aspose.Cells.NumberCategoryType.Text.

R1C1Formula

Obtém ou define uma fórmula R1C1 da Aspose.Cells.Cell.

public string R1C1Formula { get; set; }

Valor da Propriedade

string

Row

Obtém o número da linha (base zero) da célula.

public int Row { get; }

Valor da Propriedade

int

SharedStyleIndex

Obtém o índice do estilo compartilhado da célula no pool de estilos.

public int SharedStyleIndex { get; }

Valor da Propriedade

int

StringValue

Obtém o valor da string contido na célula. Se o tipo desta célula for string, então retorna o valor da string em si. Para outros tipos de célula, o valor da string formatada (formatado com o estilo especificado desta célula) será retornado. O valor da célula formatada é o mesmo que você pode obter do excel ao copiar uma célula como texto (como copiar célula para editor de texto ou exportar para csv).

public string StringValue { get; }

Valor da Propriedade

string

Type

Representa o tipo de valor da célula.

public CellValueType Type { get; }

Valor da Propriedade

CellValueType

Value

Obtém/define o valor contido nesta célula.

public object Value { get; set; }

Valor da Propriedade

object

Observações

Tipo possível:

null,

Booleano,

DateTime,

Double,

Inteiro

String.

Para valor int, pode ser retornado como um objeto Integer ou um objeto Double. E não há garantia de que o valor retornado será mantido como o mesmo tipo de objeto sempre.

Worksheet

Obtém a planilha pai.

public Worksheet Worksheet { get; }

Valor da Propriedade

Worksheet

Métodos

Calculate(CalculationOptions)

Calcula a fórmula da célula.

public void Calculate(CalculationOptions options)

Parâmetros

options CalculationOptions

Opções para cálculo

Characters(int, int)

Retorna um objeto Characters que representa um intervalo de caracteres dentro do texto da célula.

public FontSetting Characters(int startIndex, int length)

Parâmetros

startIndex int

O índice do início do caractere.

length int

O número de caracteres.

Retorna

FontSetting

Objeto Characters.

Exemplos

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

Observações

Este método funciona apenas em células com valor de string.

Copy(Cell)

Copia dados de uma célula de origem.

public void Copy(Cell cell)

Parâmetros

cell Cell

Objeto Aspose.Cells.Cell de origem.

Equals(object)

Verifica se este objeto se refere à mesma célula que outro.

public override bool Equals(object obj)

Parâmetros

obj object

outro objeto

Retorna

bool

true se dois objetos se referem à mesma célula.

Equals(Cell)

Verifica se este objeto se refere à mesma célula que outro objeto de célula.

public bool Equals(Cell cell)

Parâmetros

cell Cell

outro objeto de célula

Retorna

bool

true se dois objetos de célula se referem à mesma célula.

GetArrayRange()

Obtém o intervalo da matriz se a fórmula da célula for uma fórmula de matriz.

public CellArea GetArrayRange()

Retorna

CellArea

O intervalo da matriz.

Observações

Aplica-se somente quando a fórmula da célula é uma fórmula de matriz.

GetCharacters()

Retorna todos os objetos Characters que representam um intervalo de caracteres dentro do texto da célula.

public FontSetting[] GetCharacters()

Retorna

FontSetting[]

Todos os objetos Characters.

GetCharacters(bool)

Retorna todos os objetos Characters que representam um intervalo de caracteres dentro do texto da célula.

public FontSetting[] GetCharacters(bool flag)

Parâmetros

flag bool

Indica se aplica estilo de tabela à célula se a célula estiver na tabela.

Retorna

FontSetting[]

Todos os objetos Characters.

GetConditionalFormattingResult()

Obtém o resultado da formatação condicional.

public ConditionalFormattingResult GetConditionalFormattingResult()

Retorna

ConditionalFormattingResult

Observações

Retorna null se nenhuma formatação condicional for aplicada a esta célula.

GetDependents(bool)

Obtém todas as células cuja fórmula faz referência a esta célula diretamente.

public Cell[] GetDependents(bool isAll)

Parâmetros

isAll bool

Indica se verifica fórmulas em outras planilhas.

Retorna

Cell[]

Exemplos

Workbook workbook = new Workbook();
Cells cells = workbook.Worksheets[0].Cells;
cells["A1"].Formula = "=B1+SOMA(B1:B10)+[Book1.xls]Sheet1!B2";
cells["A2"].Formula = "=SE(TRUE,B2,B1)";
Cell[] dependents = cells["B1"].GetDependents(true);
for (int i = 0; i < dependents.Length; i++)
{
     Console.WriteLine(dependents[i].Name);
}

Observações

  • Se uma referência contendo esta célula aparecer na fórmula de uma célula, essa célula será considerada como dependente desta célula, não importando se a referência ou esta célula é usada ou não durante o cálculo. Por exemplo, embora a célula A2 na fórmula "=SE(TRUE,A1,A2)" não seja usada durante o cálculo, esta fórmula ainda é considerada dependente de A2.
  • Para obter aquelas fórmulas cujos resultados calculados dependem desta célula, por favor, use Aspose.Cells.Cell.GetDependentsInCalculation(System.Boolean).
  • Ao rastrear dependentes para uma célula, todas as fórmulas no workbook ou planilha serão analisadas e verificadas. Portanto, é um processo que consome tempo. Se o usuário precisar rastrear dependentes para muitas células, usar este método causará baixa performance. Por considerações de performance, o usuário deve usar Aspose.Cells.Cell.GetDependentsInCalculation(System.Boolean) em vez disso. Ou, o usuário pode reunir o mapa de precedentes de todas as células usando Aspose.Cells.Cell.GetPrecedents primeiro, e então construir o mapa de dependentes de acordo com o mapa de precedentes.

GetDependentsInCalculation(bool)

Obtém todas as células cujo resultado calculado depende desta célula.

public IEnumerator GetDependentsInCalculation(bool recursive)

Parâmetros

recursive bool

Indica se retorna aqueles dependentes que não fazem referência a esta célula diretamente mas fazem referência a outros elementos desta célula.

Retorna

IEnumerator

Enumerator para enumerar todos os dependentes (objetos Cell).

Exemplos

Workbook workbook = new Workbook();
Cells cells = workbook.Worksheets[0].Cells;
cells["A1"].Formula = "=B1+SOMA(B1:B10)+[Book1.xls]Sheet1!B2";
cells["A2"].Formula = "=SE(TRUE,B2,B1)";
workbook.Settings.FormulaSettings.EnableCalculationChain = true;
workbook.CalculateFormula();
IEnumerator en = cells["B1"].GetDependentsInCalculation(false);
Console.WriteLine("Dependentes de cálculo de B1:");
while(en.MoveNext())
{
    Cell c = (Cell)en.Current;
    Console.WriteLine(c.Name);
}
en = cells["B2"].GetDependentsInCalculation(false);
Console.WriteLine("Dependentes de cálculo de B2:");
while(en.MoveNext())
{
    Cell c = (Cell)en.Current;
    Console.WriteLine(c.Name);
}

Observações

Para usar este método, por favor, certifique-se de que o workbook foi configurado com valor true para Aspose.Cells.FormulaSettings.EnableCalculationChain e foi totalmente calculado com esta configuração. Se não houver referência de fórmula para esta célula, null será retornado.

GetDisplayStyle()

Obtém o estilo de exibição da célula. Se esta célula também for afetada por outras configurações, como formatação condicional, objetos de lista, etc., então o estilo de exibição pode ser diferente de cell.GetStyle().

public Style GetDisplayStyle()

Retorna

Style

GetDisplayStyle(bool)

Obtém o estilo de exibição da célula. Se a célula estiver formatada condicionalmente, o estilo de exibição não será o mesmo que cell.GetStyle().

public Style GetDisplayStyle(bool includeMergedBorders)

Parâmetros

includeMergedBorders bool

Indica se verifica as bordas das células mescladas.

Retorna

Style

GetFormatConditions()

Obtém as condições de formato que se aplicam a esta célula.

public FormatConditionCollection[] GetFormatConditions()

Retorna

FormatConditionCollection[]

Retorna o objeto Aspose.Cells.FormatConditionCollection.

GetFormula(bool, bool)

Obtém a fórmula desta célula.

public string GetFormula(bool isR1C1, bool isLocal)

Parâmetros

isR1C1 bool

Indica se a fórmula precisa ser formatada como R1C1.

isLocal bool

Indica se a fórmula precisa ser formatada pelo local.

Retorna

string

a fórmula desta célula.

GetHashCode()

Serve como uma função hash para um tipo específico.

public override int GetHashCode()

Retorna

int

Um código hash para o objeto Cell atual.

GetHeightOfValue()

Obtém a altura do valor em unidades de pixels.

public int GetHeightOfValue()

Retorna

int

GetHtmlString(bool)

Obtém a string HTML que contém dados e alguns formatos nesta célula.

public string GetHtmlString(bool html5)

Parâmetros

html5 bool

Indica se o valor é compatível com html5.

Retorna

string

GetMergedRange()

Retorna um objeto Aspose.Cells.Range que representa um intervalo mesclado.

public Range GetMergedRange()

Retorna

Range

Objeto Aspose.Cells.Range. Null se esta célula não estiver mesclada.

GetPrecedents()

Obtém todas as referências que aparecem na fórmula desta célula.

public ReferredAreaCollection GetPrecedents()

Retorna

ReferredAreaCollection

Coleção de todas as referências que aparecem na fórmula desta célula.

Exemplos

Workbook workbook = new Workbook();
Cells cells = workbook.Worksheets[0].Cells;
cells["A1"].Formula = "=B1+SOMA(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 + SOMA(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

Observações

  • Retorna null se esta não for uma célula de fórmula.
  • Todas as referências que aparecem na fórmula desta célula serão retornadas, não importando se são referenciadas ou não durante o cálculo. Por exemplo, embora a célula A2 na fórmula "=SE(TRUE,A1,A2)" não seja usada durante o cálculo, ela ainda é considerada como precedentes da fórmula.
  • Para obter aquelas referências que influenciam apenas o cálculo, por favor, use Aspose.Cells.Cell.GetPrecedentsInCalculation.

GetPrecedentsInCalculation()

Obtém todos os precedentes (referências a células no workbook atual) usados pela fórmula desta célula durante seu cálculo.

public IEnumerator GetPrecedentsInCalculation()

Retorna

IEnumerator

Enumerator para enumerar todas as referências (ReferredArea).

Exemplos

Workbook workbook = new Workbook();
Cells cells = workbook.Worksheets[0].Cells;
cells["A2"].Formula = "=SE(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);
}

Observações

Este método só pode funcionar na situação em que Aspose.Cells.FormulaSettings.EnableCalculationChain é true para o workbook e o workbook foi totalmente calculado. Se esta célula não for uma fórmula ou não fizer referência a outras células, null será retornado.

GetRichValue()

Obtém o valor rico da célula.

public CellRichValue GetRichValue()

Retorna

CellRichValue

GetStringValue(CellValueFormatStrategy)

Obtém o valor da string por estratégia de formatação específica.

public string GetStringValue(CellValueFormatStrategy formatStrategy)

Parâmetros

formatStrategy CellValueFormatStrategy

A estratégia de formatação.

Retorna

string

GetStyle()

Obtém o estilo da célula.

public Style GetStyle()

Retorna

Style

Objeto de estilo.

Observações

Para alterar o estilo da célula, por favor, chame o método Cell.SetStyle() após modificar o objeto de estilo retornado. Este método é o mesmo que Aspose.Cells.Cell.GetStyle(System.Boolean) com valor true para o parâmetro.

GetStyle(bool)

Se checkBorders for true, verifica se as bordas de outras células afetarão o estilo desta célula.

public Style GetStyle(bool checkBorders)

Parâmetros

checkBorders bool

Verifica as bordas de outras células.

Retorna

Style

Objeto de estilo.

GetTable()

Obtém a tabela que contém esta célula.

public ListObject GetTable()

Retorna

ListObject

GetValidation()

Obtém a validação aplicada a esta célula.

public Validation GetValidation()

Retorna

Validation

GetValidationValue()

Obtém o valor da validação que foi aplicada a esta célula.

public bool GetValidationValue()

Retorna

bool

GetWidthOfValue()

Obtém a largura do valor em unidades de pixels.

public int GetWidthOfValue()

Retorna

int

InsertText(int, string)

Insere alguns caracteres na célula. Se a célula estiver formatada como rica, este método pode manter a formatação original.

public void InsertText(int index, string text)

Parâmetros

index int

O índice.

text string

Texto inserido.

IsRichText()

Indica se o valor da string desta célula é um texto formatado como rico.

public bool IsRichText()

Retorna

bool

PutValue(bool)

Coloca um valor booleano na célula.

public void PutValue(bool boolValue)

Parâmetros

boolValue bool

PutValue(int)

Coloca um valor inteiro na célula.

public void PutValue(int intValue)

Parâmetros

intValue int

Valor de entrada.

PutValue(double)

Coloca um valor double na célula.

public void PutValue(double doubleValue)

Parâmetros

doubleValue double

Valor de entrada.

PutValue(string, bool, bool)

Coloca um valor na célula, se apropriado o valor será convertido para outro tipo de dado e o formato numérico da célula será redefinido.

public void PutValue(string stringValue, bool isConverted, bool setStyle)

Parâmetros

stringValue string

Valor de entrada.

isConverted bool

True: convertido para outro tipo de dado se apropriado.

setStyle bool

True: define o formato numérico para o estilo da célula ao converter para outro tipo de dado.

PutValue(string, bool)

Coloca um valor de string na célula e converte o valor para outro tipo de dado se apropriado.

public void PutValue(string stringValue, bool isConverted)

Parâmetros

stringValue string

Valor de entrada.

isConverted bool

True: convertido para outro tipo de dado se apropriado.

PutValue(string)

Coloca um valor de string na célula.

public void PutValue(string stringValue)

Parâmetros

stringValue string

Valor de entrada.

PutValue(DateTime)

Coloca um valor DateTime na célula.

public void PutValue(DateTime dateTime)

Parâmetros

dateTime DateTime

Valor de entrada.

Exemplos

Este exemplo mostra como definir um valor DateTime para uma célula e fazê-la ser exibida como data e hora.

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

//Colocar data e hora em uma célula
Cell cell = cells[0, 0];
cell.PutValue(new DateTime(2023, 5, 15));
Style style = cell.GetStyle(false);
style.Number = 14;
cell.SetStyle(style);

Observações

Definir um valor DateTime para uma célula não significa que a célula será formatada como data e hora automaticamente. O valor DateTime é mantido como um valor numérico no modelo de dados tanto do ms excel quanto do Aspose.Cells. Se o valor numérico será considerado como o valor numérico em si ou data e hora depende do formato numérico aplicado a esta célula. Se esta célula não foi formatada como data e hora, ela será exibida como um valor numérico, mesmo que o que você insira seja DateTime.

PutValue(object)

Coloca um valor de objeto na célula.

public void PutValue(object objectValue)

Parâmetros

objectValue object

valor de entrada.

RemoveArrayFormula(bool)

Remove a fórmula de matriz.

public void RemoveArrayFormula(bool leaveNormalFormula)

Parâmetros

leaveNormalFormula bool

True representa converter a fórmula de matriz em uma fórmula normal.

Replace(string, string, ReplaceOptions)

Substitui o texto da célula com opções.

public void Replace(string placeHolder, string newValue, ReplaceOptions options)

Parâmetros

placeHolder string

Placeholder da célula.

newValue string

Valor da string para substituir.

options ReplaceOptions

As opções de substituição.

SetArrayFormula(string, int, int)

Define uma fórmula de matriz (fórmula de matriz legada inserida via CTRL+SHIFT+ENTER no ms excel) para um intervalo de células.

public void SetArrayFormula(string arrayFormula, int rowNumber, int columnNumber)

Parâmetros

arrayFormula string

Fórmula de matriz.

rowNumber int

Número de linhas para preencher o resultado da fórmula de matriz.

columnNumber int

Número de colunas para preencher o resultado da fórmula de matriz.

SetArrayFormula(string, int, int, FormulaParseOptions)

Define uma fórmula de matriz para um intervalo de células.

public void SetArrayFormula(string arrayFormula, int rowNumber, int columnNumber, FormulaParseOptions options)

Parâmetros

arrayFormula string

Fórmula de matriz.

rowNumber int

Número de linhas para preencher o resultado da fórmula de matriz.

columnNumber int

Número de colunas para preencher o resultado da fórmula de matriz.

options FormulaParseOptions

Opções para analisar a fórmula.

SetArrayFormula(string, int, int, FormulaParseOptions, object[][])

Define uma fórmula de matriz para um intervalo de células.

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 linhas para preencher o resultado da fórmula de matriz.

columnNumber int

Número de colunas para preencher o resultado da fórmula de matriz.

options FormulaParseOptions

Opções para analisar a fórmula.

values object[][]

valores para aquelas células com a fórmula de matriz dada.

SetCharacters(FontSetting[])

Define o formato de texto rico da célula.

public void SetCharacters(FontSetting[] characters)

Parâmetros

characters FontSetting[]

Todos os objetos Characters.

SetDynamicArrayFormula(string, FormulaParseOptions, bool)

Define uma fórmula de matriz dinâmica e faz com que a fórmula se espalhe para células vizinhas, se possível.

public CellArea SetDynamicArrayFormula(string arrayFormula, FormulaParseOptions options, bool calculateValue)

Parâmetros

arrayFormula string

a expressão da fórmula.

options FormulaParseOptions

opções para analisar a fórmula. A opção “Parse” será ignorada e a fórmula será sempre analisada imediatamente.

calculateValue bool

se calcular este valor da fórmula de matriz dinâmica para aquelas células no intervalo espalhado.

Retorna

CellArea

o intervalo que a fórmula deve se espalhar.

Observações

o intervalo retornado pode não ser o mesmo que o real que esta fórmula de matriz dinâmica se espalha. Se houver células não vazias no intervalo, a fórmula será definida apenas para a célula atual e marcada como “#SPILL!”. Mas para esse tipo de situação, ainda retornamos o intervalo inteiro que esta fórmula deve se espalhar.

SetDynamicArrayFormula(string, FormulaParseOptions, object[][], bool, bool)

Define uma fórmula de matriz dinâmica e faz com que a fórmula se espalhe para células vizinhas, se possível.

public CellArea SetDynamicArrayFormula(string arrayFormula, FormulaParseOptions options, object[][] values, bool calculateRange, bool calculateValue)

Parâmetros

arrayFormula string

a expressão da fórmula.

options FormulaParseOptions

opções para analisar a fórmula. A opção “Parse” será ignorada e a fórmula será sempre analisada imediatamente.

values object[][]

valores (resultados calculados) para aquelas células com a fórmula de matriz dinâmica dada.

calculateRange bool

Se calcular o intervalo espalhado para esta fórmula de matriz dinâmica. Se o parâmetro “values” não for nulo e essa marca for falsa, então a altura do intervalo espalhado será values.Length e a largura será values[0].Length.

calculateValue bool

se calcular esta fórmula de matriz dinâmica para aquelas células no intervalo espalhado quando “values” for nulo ou o item correspondente em “values” para uma célula for nulo.

Retorna

CellArea

o intervalo que a fórmula deve se espalhar.

Observações

o intervalo retornado pode não ser o mesmo que o real que esta fórmula de matriz dinâmica se espalha. Se houver células não vazias no intervalo, a fórmula será definida apenas para a célula atual e marcada como “#SPILL!”. Mas para esse tipo de situação, ainda retornamos o intervalo inteiro que esta fórmula deve se espalhar.

SetDynamicArrayFormula(string, FormulaParseOptions, object[][], bool, bool, CalculationOptions)

Define uma fórmula de matriz dinâmica e faz com que a fórmula se espalhe para células vizinhas, se possível.

public CellArea SetDynamicArrayFormula(string arrayFormula, FormulaParseOptions options, object[][] values, bool calculateRange, bool calculateValue, CalculationOptions copts)

Parâmetros

arrayFormula string

a expressão da fórmula.

options FormulaParseOptions

opções para analisar a fórmula. A opção “Parse” será ignorada e a fórmula será sempre analisada imediatamente.

values object[][]

valores (resultados calculados) para aquelas células com a fórmula de matriz dinâmica dada.

calculateRange bool

Se calcular o intervalo espalhado para esta fórmula de matriz dinâmica. Se o parâmetro “values” não for nulo e essa marca for falsa, então a altura do intervalo espalhado será values.Length e a largura será values[0].Length.

calculateValue bool

se calcular esta fórmula de matriz dinâmica para aquelas células no intervalo espalhado quando “values” for nulo ou o item correspondente em “values” para uma célula for nulo.

copts CalculationOptions

As opções para calcular a fórmula. Comumente, por considerações de performance, a propriedade Aspose.Cells.CalculationOptions.Recursive deve ser falsa.

Retorna

CellArea

o intervalo que a fórmula deve se espalhar.

Observações

o intervalo retornado pode não ser o mesmo que o real que esta fórmula de matriz dinâmica se espalha. Se houver células não vazias no intervalo, a fórmula será definida apenas para a célula atual e marcada como “#SPILL!”. Mas para esse tipo de situação, ainda retornamos o intervalo inteiro que esta fórmula deve se espalhar.

SetFormula(string, object)

Define a fórmula e o valor (resultado calculado) da fórmula.

public void SetFormula(string formula, object value)

Parâmetros

formula string

A fórmula.

value object

O valor (resultado calculado) da fórmula.

SetFormula(string, FormulaParseOptions)

Define a fórmula e o valor (resultado calculado) da fórmula.

public void SetFormula(string formula, FormulaParseOptions options)

Parâmetros

formula string

A fórmula.

options FormulaParseOptions

Opções para analisar a fórmula.

SetFormula(string, FormulaParseOptions, object)

Define a fórmula e o valor (resultado calculado) da fórmula.

public void SetFormula(string formula, FormulaParseOptions options, object value)

Parâmetros

formula string

A fórmula.

options FormulaParseOptions

Opções para analisar a fórmula.

value object

O valor (resultado calculado) da fórmula.

SetSharedFormula(string, int, int)

Define fórmulas compartilhadas para um intervalo de células.

public void SetSharedFormula(string sharedFormula, int rowNumber, int columnNumber)

Parâmetros

sharedFormula string

Fórmula compartilhada.

rowNumber int

Número de linhas para preencher a fórmula.

columnNumber int

Número de colunas para preencher a fórmula.

SetSharedFormula(string, int, int, FormulaParseOptions)

Define fórmulas compartilhadas para um intervalo de células.

public void SetSharedFormula(string sharedFormula, int rowNumber, int columnNumber, FormulaParseOptions options)

Parâmetros

sharedFormula string

Fórmula compartilhada.

rowNumber int

Número de linhas para preencher a fórmula.

columnNumber int

Número de colunas para preencher a fórmula.

options FormulaParseOptions

Opções para analisar a fórmula.

SetSharedFormula(string, int, int, FormulaParseOptions, object[][])

Define fórmulas compartilhadas para um intervalo de células.

public void SetSharedFormula(string sharedFormula, int rowNumber, int columnNumber, FormulaParseOptions options, object[][] values)

Parâmetros

sharedFormula string

Fórmula compartilhada.

rowNumber int

Número de linhas para preencher a fórmula.

columnNumber int

Número de colunas para preencher a fórmula.

options FormulaParseOptions

Opções para analisar a fórmula.

values object[][]

valores para aquelas células com a fórmula compartilhada dada.

SetStyle(Style)

Define o estilo da célula.

public void SetStyle(Style style)

Parâmetros

style Style

O estilo da célula.

Observações

Se as configurações de borda forem alteradas, a borda das células ajustadas também será atualizada.

SetStyle(Style, bool)

Aplica a propriedade alterada do estilo à célula.

public void SetStyle(Style style, bool explicitFlag)

Parâmetros

style Style

O estilo da célula.

explicitFlag bool

True, sobrescrevendo apenas a formatação que é definida explicitamente.

SetStyle(Style, StyleFlag)

Aplica o estilo da célula com base em flags.

public void SetStyle(Style style, StyleFlag flag)

Parâmetros

style Style

O estilo da célula.

flag StyleFlag

A flag de estilo.

SetTableFormula(int, int, string, string, object[][])

Cria uma tabela de dados de duas variáveis para o intervalo dado a partir desta célula.

public void SetTableFormula(int rowNumber, int columnNumber, string rowInputCell, string columnInputCell, object[][] values)

Parâmetros

rowNumber int

Número de linhas para preencher a fórmula.

columnNumber int

Número de colunas para preencher a fórmula.

rowInputCell string

a célula de entrada da linha.

columnInputCell string

a célula de entrada da coluna.

values object[][]

valores para células no intervalo da fórmula da tabela.

SetTableFormula(int, int, string, bool, object[][])

Cria uma tabela de dados de uma variável para o intervalo dado a partir desta célula.

public void SetTableFormula(int rowNumber, int columnNumber, string inputCell, bool isRowInput, object[][] values)

Parâmetros

rowNumber int

Número de linhas para preencher a fórmula.

columnNumber int

Número de colunas para preencher a fórmula.

inputCell string

a célula de entrada.

isRowInput bool

Indica se a célula de entrada é uma célula de entrada de linha (true) ou uma célula de entrada de coluna (false).

values object[][]

valores para células no intervalo da fórmula da tabela.

SetTableFormula(int, int, int, int, int, int, object[][])

Cria uma tabela de dados de duas variáveis para o intervalo dado a partir desta célula.

public void SetTableFormula(int rowNumber, int columnNumber, int rowIndexOfRowInputCell, int columnIndexOfRowInputCell, int rowIndexOfColumnInputCell, int columnIndexOfColumnInputCell, object[][] values)

Parâmetros

rowNumber int

Número de linhas para preencher a fórmula.

columnNumber int

Número de colunas para preencher a fórmula.

rowIndexOfRowInputCell int

índice da linha da célula de entrada da linha.

columnIndexOfRowInputCell int

índice da coluna da célula de entrada da linha.

rowIndexOfColumnInputCell int

índice da linha da célula de entrada da coluna.

columnIndexOfColumnInputCell int

índice da coluna da célula de entrada da coluna.

values object[][]

valores para células no intervalo da fórmula da tabela.

SetTableFormula(int, int, int, int, bool, object[][])

Cria uma tabela de dados de uma variável para o intervalo dado a partir desta célula.

public void SetTableFormula(int rowNumber, int columnNumber, int rowIndexOfInputCell, int columnIndexOfInputCell, bool isRowInput, object[][] values)

Parâmetros

rowNumber int

Número de linhas para preencher a fórmula.

columnNumber int

Número de colunas para preencher a fórmula.

rowIndexOfInputCell int

índice da linha da célula de entrada.

columnIndexOfInputCell int

índice da coluna da célula de entrada.

isRowInput bool

Indica se a célula de entrada é uma célula de entrada de linha (true) ou uma célula de entrada de coluna (false).

values object[][]

valores para células no intervalo da fórmula da tabela.

ToJson()

Converte Aspose.Cells.Cell para dados estruturados JSON.

public string ToJson()

Retorna

string

ToString()

Retorna uma string que representa o objeto Cell atual.

public override string ToString()

Retorna

string

 Português