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
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
Column
Obtém o número da coluna (base zero) da célula.
public int Column { get; }
Valor da Propriedade
Comment
Obtém o comentário desta célula.
public Comment Comment { get; }
Valor da Propriedade
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
DateTimeValue
Obtém o valor DateTime contido na célula.
public DateTime DateTimeValue { get; }
Valor da Propriedade
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
DoubleValue
Obtém o valor double contido na célula.
public double DoubleValue { get; }
Valor da Propriedade
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
Formula
Obtém ou define uma fórmula da Aspose.Cells.Cell.
public string Formula { get; set; }
Valor da Propriedade
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
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
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
IntValue
Obtém o valor inteiro contido na célula.
public int IntValue { get; }
Valor da Propriedade
IsArrayFormula
Indica se a fórmula da célula é uma fórmula de matriz.
public bool IsArrayFormula { get; }
Valor da Propriedade
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
IsCheckBoxStyle
Indica se a célula está definida como uma caixa de seleção.
public bool IsCheckBoxStyle { get; set; }
Valor da Propriedade
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
IsErrorValue
Verifica se o valor desta célula é um erro.
public bool IsErrorValue { get; }
Valor da Propriedade
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
IsMerged
Verifica se uma célula faz parte de um intervalo mesclado ou não.
public bool IsMerged { get; }
Valor da Propriedade
IsNumericValue
Indica se o valor desta célula é numérico (int, double e datetime).
public bool IsNumericValue { get; }
Valor da Propriedade
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
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
IsTableFormula
Indica se esta célula faz parte de uma fórmula de tabela.
public bool IsTableFormula { get; }
Valor da Propriedade
Name
Obtém o nome da célula.
public string Name { get; }
Valor da Propriedade
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
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
Row
Obtém o número da linha (base zero) da célula.
public int Row { get; }
Valor da Propriedade
SharedStyleIndex
Obtém o índice do estilo compartilhado da célula no pool de estilos.
public int SharedStyleIndex { get; }
Valor da Propriedade
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
Type
Representa o tipo de valor da célula.
public CellValueType Type { get; }
Valor da Propriedade
Value
Obtém/define o valor contido nesta célula.
public object Value { get; set; }
Valor da Propriedade
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
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
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
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
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
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
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
Todos os objetos Characters.
GetConditionalFormattingResult()
Obtém o resultado da formatação condicional.
public ConditionalFormattingResult GetConditionalFormattingResult()
Retorna
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
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
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
GetFormatConditions()
Obtém as condições de formato que se aplicam a esta célula.
public FormatConditionCollection[] GetFormatConditions()
Retorna
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
a fórmula desta célula.
GetHashCode()
Serve como uma função hash para um tipo específico.
public override int GetHashCode()
Retorna
Um código hash para o objeto Cell atual.
GetHeightOfValue()
Obtém a altura do valor em unidades de pixels.
public int GetHeightOfValue()
Retorna
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
GetMergedRange()
Retorna um objeto Aspose.Cells.Range que representa um intervalo mesclado.
public Range GetMergedRange()
Retorna
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
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
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
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
GetStyle()
Obtém o estilo da célula.
public Style GetStyle()
Retorna
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
Objeto de estilo.
GetTable()
Obtém a tabela que contém esta célula.
public ListObject GetTable()
Retorna
GetValidation()
Obtém a validação aplicada a esta célula.
public Validation GetValidation()
Retorna
GetValidationValue()
Obtém o valor da validação que foi aplicada a esta célula.
public bool GetValidationValue()
Retorna
GetWidthOfValue()
Obtém a largura do valor em unidades de pixels.
public int GetWidthOfValue()
Retorna
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
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
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
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
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
ToString()
Retorna uma string que representa o objeto Cell atual.
public override string ToString()