Class Cell
Namespace: Aspose.Cells
Assembly: Aspose.Cells.dll (25.2.0)
Інкапсулює об’єкт, який представляє одну клітинку Workbook.
public class Cell
Спадкування
Спадковані члени
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Приклади
Workbook excel = new Workbook();
Cells cells = excel.Worksheets[0].Cells;
//Вставити рядок у клітинку
Cell cell = cells[0, 0];
cell.PutValue("Привіт");
string first = cell.StringValue;
//Вставити ціле число у клітинку
cell = cells["B1"];
cell.PutValue(12);
int second = cell.IntValue;
//Вставити дробове число у клітинку
cell = cells[0, 2];
cell.PutValue(-1.234);
double third = cell.DoubleValue;
//Вставити формулу у клітинку
cell = cells["D1"];
cell.Formula = "=B1 + C1";
//Вставити комбіновану формулу: "sum(average(b1,c1), b1)" у клітинку b2
cell = cells["b2"];
cell.Formula = "=sum(average(b1,c1), b1)";
//Встановити стиль клітинки
Style style = cell.GetStyle();
//Встановити колір фону
style.BackgroundColor = Color.Yellow;
//Встановити шрифт клітинки
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
'Вставити рядок у клітинку
Dim cell as Cell = cells(0, 0)
cell.PutValue("Привіт")
Dim first as String = cell.StringValue
'Вставити ціле число у клітинку
cell = cells("B1")
cell.PutValue(12)
Dim second as Integer = cell.IntValue
'Вставити дробове число у клітинку
cell = cells(0, 2)
cell.PutValue(-1.234)
Dim third as Double = cell.DoubleValue
'Вставити формулу у клітинку
cell = cells("D1")
cell.Formula = "=B1 + C1"
'Вставити комбіновану формулу: "sum(average(b1,c1), b1)" у клітинку b2
cell = cells("b2")
cell.Formula = "=sum(average(b1,c1), b1)"
'Встановити стиль клітинки
Dim style as Style = cell.GetStyle()
'Встановити колір фону
style.BackgroundColor = Color.Yellow
'Встановити шрифт клітинки
style.Font.Name = "Courier New"
style.VerticalAlignment = TextAlignmentType.Top
cell.SetStyle(style)
Властивості
BoolValue
Отримує булеве значення, що міститься у клітинці.
public bool BoolValue { get; }
Значення властивості
Column
Отримує номер стовпця (нульовий) клітинки.
public int Column { get; }
Значення властивості
Comment
Отримує коментар цієї клітинки.
public Comment Comment { get; }
Значення властивості
Зауваження
Якщо для клітинки немає коментаря, повертає null.
ContainsExternalLink
Вказує, чи містить ця клітинка зовнішнє посилання. Застосовується лише тоді, коли клітинка є формульною.
public bool ContainsExternalLink { get; }
Значення властивості
DateTimeValue
Отримує значення DateTime, що міститься у клітинці.
public DateTime DateTimeValue { get; }
Значення властивості
DisplayStringValue
Отримує відформатоване рядкове значення цієї клітинки відповідно до стилю відображення клітинки.
public string DisplayStringValue { get; }
Значення властивості
DoubleValue
Отримує дробове значення, що міститься у клітинці.
public double DoubleValue { get; }
Значення властивості
EmbeddedImage
Отримує та встановлює вбудоване зображення у клітинці.
public byte[] EmbeddedImage { get; set; }
Значення властивості
byte[]
FloatValue
Отримує значення з плаваючою комою, що міститься у клітинці.
public float FloatValue { get; }
Значення властивості
Formula
Отримує або встановлює формулу Aspose.Cells.Cell.
public string Formula { get; set; }
Значення властивості
Приклади
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"
Зауваження
Рядок формули завжди починається з знака рівності (=). І будь ласка, завжди використовуйте кому (,) як роздільник параметрів, наприклад, “=SUM(A1, E1, H2)”.
FormulaLocal
Отримує формулу клітинки у форматі локалі.
public string FormulaLocal { get; set; }
Значення властивості
HasCustomStyle
Вказує, чи має ця клітинка налаштування стилю, відмінні від стандартного, успадкованого від відповідного рядка, стовпця або книги.
public bool HasCustomStyle { get; }
Значення властивості
HtmlString
Отримує та встановлює html рядок, який містить дані та деякі формати в цій клітинці.
public string HtmlString { get; set; }
Значення властивості
IntValue
Отримує ціле значення, що міститься у клітинці.
public int IntValue { get; }
Значення властивості
IsArrayFormula
Вказує, чи є формула клітинки масивною формулою.
public bool IsArrayFormula { get; }
Значення властивості
IsArrayHeader
Вказує, що формула клітинки є масивною формулою і це перша клітинка масиву.
public bool IsArrayHeader { get; }
Значення властивості
IsCheckBoxStyle
Вказує, чи є ця клітинка стилем прапорця.
public bool IsCheckBoxStyle { get; set; }
Значення властивості
IsDynamicArrayFormula
Вказує, чи є формула клітинки динамічною масивною формулою (true) або застарілою масивною формулою (false).
public bool IsDynamicArrayFormula { get; }
Значення властивості
IsErrorValue
Перевіряє, чи є значення цієї клітинки помилкою.
public bool IsErrorValue { get; }
Значення властивості
Зауваження
Також застосовується до формульної клітинки, щоб перевірити, чи є обчислений результат помилкою.
IsFormula
Представляє, чи містить вказана клітинка формулу.
public bool IsFormula { get; }
Значення властивості
IsMerged
Перевіряє, чи є клітинка частиною злитого діапазону.
public bool IsMerged { get; }
Значення властивості
IsNumericValue
Вказує, чи є значення цієї клітинки числовим (int, double та datetime)
public bool IsNumericValue { get; }
Значення властивості
Зауваження
Також застосовується до формульної клітинки, щоб перевірити обчислений результат.
IsSharedFormula
Вказує, чи є формула клітинки частиною спільної формули.
public bool IsSharedFormula { get; }
Значення властивості
IsStyleSet
Вказує, чи встановлено стиль клітинки. Якщо повертає false, це означає, що ця клітинка має стандартний формат клітинки.
public bool IsStyleSet { get; }
Значення властивості
IsTableFormula
Вказує, чи є ця клітинка частиною формули таблиці.
public bool IsTableFormula { get; }
Значення властивості
Name
Отримує ім’я клітинки.
public string Name { get; }
Значення властивості
Зауваження
Ім’я клітинки включає літеру стовпця та номер рядка. Наприклад, ім’я клітинки в рядку 0 та стовпці 0 - це A1.
NumberCategoryType
Представляє тип категорії форматування числа цієї клітинки.
public NumberCategoryType NumberCategoryType { get; }
Значення властивості
Зауваження
Коли шаблон форматування клітинки поєднується з умовними шаблонами форматування, повернутий тип відповідає частині, що використовується для поточного значення цієї клітинки. Наприклад, якщо шаблон форматування для цієї клітинки “#,##0;(#,##0);”-";@", тоді, коли значення клітинки є числовим і не 0, повернений тип - Aspose.Cells.NumberCategoryType.Number; Коли значення клітинки є 0 або нечисловим значенням, повернений тип - Aspose.Cells.NumberCategoryType.Text.
R1C1Formula
Отримує або встановлює R1C1 формулу Aspose.Cells.Cell.
public string R1C1Formula { get; set; }
Значення властивості
Row
Отримує номер рядка (нульовий) клітинки.
public int Row { get; }
Значення властивості
SharedStyleIndex
Отримує індекс спільного стилю клітинки в пулі стилів.
public int SharedStyleIndex { get; }
Значення властивості
StringValue
Отримує рядкове значення, що міститься у клітинці. Якщо тип цієї клітинки - рядок, то повертається саме рядкове значення. Для інших типів клітинок буде повернено відформатоване рядкове значення (відформатоване відповідно до вказаного стилю цієї клітинки). Відформатоване значення клітинки таке ж, як те, що ви можете отримати з excel, копіюючи клітинку як текст (наприклад, копіюючи клітинку в текстовий редактор або експортування в csv).
public string StringValue { get; }
Значення властивості
Type
Представляє тип значення клітинки.
public CellValueType Type { get; }
Значення властивості
Value
Отримує/встановлює значення, що міститься у цій клітинці.
public object Value { get; set; }
Значення властивості
Зауваження
Можливі типи:
null,
Boolean,
DateTime,
Double,
Integer
String.
Для значення int воно може бути повернуте як об’єкт Integer або об’єкт Double. І немає гарантії, що повернуте значення завжди буде зберігатися як той самий тип об’єкта.Worksheet
Отримує батьківський аркуш.
public Worksheet Worksheet { get; }
Значення властивості
Методи
Calculate(CalculationOptions)
Обчислює формулу клітинки.
public void Calculate(CalculationOptions options)
Параметри
options
CalculationOptions
Параметри для обчислення
Characters(int, int)
Повертає об’єкт Characters, який представляє діапазон символів у тексті клітинки.
public FontSetting Characters(int startIndex, int length)
Параметри
startIndex
int
Індекс початку символу.
length
int
Кількість символів.
Повертає
Об’єкт Characters.
Приклади
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
Зауваження
Цей метод працює лише з клітинкою, що містить рядкове значення.
Copy(Cell)
Копіює дані з вихідної клітинки.
public void Copy(Cell cell)
Параметри
cell
Cell
Об’єкт Aspose.Cells.Cell джерела.
Equals(object)
Перевіряє, чи цей об’єкт посилається на ту ж клітинку, що й інша.
public override bool Equals(object obj)
Параметри
obj
object
інший об’єкт
Повертає
true, якщо два об’єкти посилаються на ту ж клітинку.
Equals(Cell)
Перевіряє, чи цей об’єкт посилається на ту ж клітинку, що й інший об’єкт клітинки.
public bool Equals(Cell cell)
Параметри
cell
Cell
інший об’єкт клітинки
Повертає
true, якщо два об’єкти клітинки посилаються на ту ж клітинку.
GetArrayRange()
Отримує діапазон масиву, якщо формула клітинки є масивною формулою.
public CellArea GetArrayRange()
Повертає
Діапазон масиву.
Зауваження
Застосовується лише, якщо формула клітинки є масивною формулою.
GetCharacters()
Повертає всі об’єкти Characters які представляють діапазон символів у тексті клітинки.
public FontSetting[] GetCharacters()
Повертає
Усі об’єкти Characters.
GetCharacters(bool)
Повертає всі об’єкти Characters які представляють діапазон символів у тексті клітинки.
public FontSetting[] GetCharacters(bool flag)
Параметри
flag
bool
Вказує, чи застосовувати стиль таблиці до клітинки, якщо клітинка знаходиться в таблиці.
Повертає
Усі об’єкти Characters.
GetConditionalFormattingResult()
Отримує результат умовного форматування.
public ConditionalFormattingResult GetConditionalFormattingResult()
Повертає
Зауваження
Повертає null, якщо до цієї клітинки не застосовано умовне форматування.
GetDependents(bool)
Отримує всі клітинки, формула яких безпосередньо посилається на цю клітинку.
public Cell[] GetDependents(bool isAll)
Параметри
isAll
bool
Вказує, чи перевіряти формули в інших аркушах.
Повертає
Cell[]
Приклади
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);
}
Зауваження
- Якщо одне посилання, що містить цю клітинку, з'являється у формулі однієї клітинки, ця клітинка буде вважатися залежною від цієї клітинки, незалежно від того, чи використовується посилання або ця клітинка під час обчислення. Наприклад, хоча клітинка A2 у формулі "=IF(TRUE,A1,A2)" не використовується під час обчислення, ця формула все ще вважається залежною від A2.
- Щоб отримати ті формули, результати яких залежать від цієї клітинки, будь ласка, використовуйте Aspose.Cells.Cell.GetDependentsInCalculation(System.Boolean).
- При трасуванні залежностей для однієї клітинки всі формули в книзі або аркуші будуть проаналізовані та перевірені. Тому це процес, що вимагає часу. Якщо користувачеві потрібно трасувати залежності для багатьох клітинок, використання цього методу призведе до погіршення продуктивності. З метою продуктивності користувач повинен використовувати Aspose.Cells.Cell.GetDependentsInCalculation(System.Boolean) замість цього. Або, користувач може спочатку зібрати карту попередників усіх клітинок за допомогою Aspose.Cells.Cell.GetPrecedents, а потім побудувати карту залежностей відповідно до карти попередників.
GetDependentsInCalculation(bool)
Отримує всі клітинки, результати обчислення яких залежать від цієї клітинки.
public IEnumerator GetDependentsInCalculation(bool recursive)
Параметри
recursive
bool
Чи повертає ті залежності, які не посилаються на цю клітинку безпосередньо, але посилаються на інші елементи цієї клітинки.
Повертає
Перерахувач для перерахунку всіх залежностей (об’єктів Cell).
Приклади
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("Залежності обчислення B1:");
while(en.MoveNext())
{
Cell c = (Cell)en.Current;
Console.WriteLine(c.Name);
}
en = cells["B2"].GetDependentsInCalculation(false);
Console.WriteLine("Залежності обчислення B2:");
while(en.MoveNext())
{
Cell c = (Cell)en.Current;
Console.WriteLine(c.Name);
}
Зауваження
Щоб використовувати цей метод, будь ласка, переконайтеся, що книга була налаштована з true для Aspose.Cells.FormulaSettings.EnableCalculationChain і була повністю обчислена з цим налаштуванням. Якщо немає формули, що посилається на цю клітинку, повернеться null.
GetDisplayStyle()
Отримує стиль відображення клітинки. Якщо ця клітинка також підлягає впливу інших налаштувань, таких як умовне форматування, об’єкти списків тощо, тоді стиль відображення може відрізнятися від cell.GetStyle().
public Style GetDisplayStyle()
Повертає
GetDisplayStyle(bool)
Отримує стиль відображення клітинки. Якщо клітинка має умовне форматування, стиль відображення не буде таким же, як cell.GetStyle().
public Style GetDisplayStyle(bool includeMergedBorders)
Параметри
includeMergedBorders
bool
Вказує, чи перевіряти кордони злитих клітинок.
Повертає
GetFormatConditions()
Отримує умови форматування, які застосовуються до цієї клітинки.
public FormatConditionCollection[] GetFormatConditions()
Повертає
Повертає об’єкт Aspose.Cells.FormatConditionCollection.
GetFormula(bool, bool)
Отримує формулу цієї клітинки.
public string GetFormula(bool isR1C1, bool isLocal)
Параметри
isR1C1
bool
Чи потрібно форматувати формулу як R1C1.
isLocal
bool
Чи потрібно форматувати формулу за локаллю.
Повертає
формула цієї клітинки.
GetHashCode()
Служить як хеш-функція для певного типу.
public override int GetHashCode()
Повертає
Хеш-код для поточного об’єкта Cell.
GetHeightOfValue()
Отримує висоту значення в одиницях пікселів.
public int GetHeightOfValue()
Повертає
GetHtmlString(bool)
Отримує html рядок, який містить дані та деякі формати в цій клітинці.
public string GetHtmlString(bool html5)
Параметри
html5
bool
Вказує, чи значення сумісне з html5.
Повертає
GetMergedRange()
Повертає об’єкт Aspose.Cells.Range, який представляє злитий діапазон.
public Range GetMergedRange()
Повертає
Об’єкт Aspose.Cells.Range. Null, якщо ця клітинка не злитий.
GetPrecedents()
Отримує всі посилання, що з’являються у формулі цієї клітинки.
public ReferredAreaCollection GetPrecedents()
Повертає
Колекція всіх посилань, що з’являються у формулі цієї клітинки.
Приклади
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
Зауваження
- Повертає null, якщо це не формульна клітинка.
- Усі посилання, що з'являються у формулі цієї клітинки, будуть повернуті, незалежно від того, чи вони посилаються чи ні під час обчислення. Наприклад, хоча клітинка A2 у формулі "=IF(TRUE,A1,A2)" не використовується під час обчислення, вона все ще вважається попередником формули.
- Щоб отримати ті посилання, які впливають на обчислення, будь ласка, використовуйте Aspose.Cells.Cell.GetPrecedentsInCalculation.
GetPrecedentsInCalculation()
Отримує всі попередники (посилання на клітинки в поточній книзі), які використовуються формулою цієї клітинки під час її обчислення.
public IEnumerator GetPrecedentsInCalculation()
Повертає
Перерахувач для перерахунку всіх посилань (ReferredArea).
Приклади
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("Попередники обчислення A2:");
while(en.MoveNext())
{
ReferredArea r = (ReferredArea)en.Current;
Console.WriteLine(r);
}
Зауваження
Цей метод може працювати лише в ситуації, коли Aspose.Cells.FormulaSettings.EnableCalculationChain є true для книги, і книга була повністю обчислена. Якщо ця клітинка не є формулою або вона не посилається на жодні інші клітинки, повернеться null.
GetRichValue()
Отримує багатозначне значення клітинки.
public CellRichValue GetRichValue()
Повертає
GetStringValue(CellValueFormatStrategy)
Отримує рядкове значення за специфічною форматовою стратегією.
public string GetStringValue(CellValueFormatStrategy formatStrategy)
Параметри
formatStrategy
CellValueFormatStrategy
Форматна стратегія.
Повертає
GetStyle()
Отримує стиль клітинки.
public Style GetStyle()
Повертає
Об’єкт стилю.
Зауваження
Щоб змінити стиль клітинки, будь ласка, викликайте метод Cell.SetStyle() після модифікації повернутого об’єкта стилю. Цей метод є тим же, що і Aspose.Cells.Cell.GetStyle(System.Boolean) з true значенням для параметра.
GetStyle(bool)
Якщо checkBorders є true, перевіряє, чи впливають кордони інших клітинок на стиль цієї клітинки.
public Style GetStyle(bool checkBorders)
Параметри
checkBorders
bool
Перевіряє кордони інших клітинок.
Повертає
Об’єкт стилю.
GetTable()
Отримує таблицю, яка містить цю клітинку.
public ListObject GetTable()
Повертає
GetValidation()
Отримує перевірку, застосовану до цієї клітинки.
public Validation GetValidation()
Повертає
GetValidationValue()
Отримує значення перевірки, яке застосоване до цієї клітинки.
public bool GetValidationValue()
Повертає
GetWidthOfValue()
Отримує ширину значення в одиницях пікселів.
public int GetWidthOfValue()
Повертає
InsertText(int, string)
Вставляє кілька символів у клітинку. Якщо клітинка має багатоформатне оформлення, цей метод може зберегти оригінальне форматування.
public void InsertText(int index, string text)
Параметри
index
int
Індекс.
text
string
Вставлений текст.
IsRichText()
Вказує, чи є рядкове значення цієї клітинки текстом з багатим форматуванням.
public bool IsRichText()
Повертає
PutValue(bool)
Вставляє булеве значення у клітинку.
public void PutValue(bool boolValue)
Параметри
boolValue
bool
PutValue(int)
Вставляє ціле число у клітинку.
public void PutValue(int intValue)
Параметри
intValue
int
Вхідне значення.
PutValue(double)
Вставляє дробове число у клітинку.
public void PutValue(double doubleValue)
Параметри
doubleValue
double
Вхідне значення.
PutValue(string, bool, bool)
Вставляє значення у клітинку, за необхідності значення буде перетворено в інший тип даних, а формат числа клітинки буде скинуто.
public void PutValue(string stringValue, bool isConverted, bool setStyle)
Параметри
stringValue
string
Вхідне значення.
isConverted
bool
True: перетворити в інший тип даних, якщо це доречно.
setStyle
bool
True: встановити формат числа на стиль клітинки під час перетворення в інший тип даних.
PutValue(string, bool)
Вставляє рядкове значення у клітинку та за необхідності перетворює значення в інший тип даних.
public void PutValue(string stringValue, bool isConverted)
Параметри
stringValue
string
Вхідне значення.
isConverted
bool
True: перетворити в інший тип даних, якщо це доречно.
PutValue(string)
Вставляє рядкове значення у клітинку.
public void PutValue(string stringValue)
Параметри
stringValue
string
Вхідне значення.
PutValue(DateTime)
Вставляє значення DateTime у клітинку.
public void PutValue(DateTime dateTime)
Параметри
dateTime
DateTime
Вхідне значення.
Приклади
Цей приклад показує, як встановити значення DateTime для клітинки та відобразити його як дату.
Workbook excel = new Workbook();
Cells cells = excel.Worksheets[0].Cells;
//Вставити дату у клітинку
Cell cell = cells[0, 0];
cell.PutValue(new DateTime(2023, 5, 15));
Style style = cell.GetStyle(false);
style.Number = 14;
cell.SetStyle(style);
Зауваження
Встановлення значення DateTime для клітинки не означає, що клітинка автоматично буде форматована як дата. Значення DateTime зберігається як числове значення в моделі даних як ms excel, так і Aspose.Cells. Чи буде числове значення сприйматися як саме числове значення або як дата залежить від формату числа, застосованого до цієї клітинки. Якщо ця клітинка не була відформатована як дата, вона буде відображена як числове значення, навіть якщо ви ввели DateTime.
PutValue(object)
Вставляє об’єктне значення у клітинку.
public void PutValue(object objectValue)
Параметри
objectValue
object
вхідне значення.
RemoveArrayFormula(bool)
Видаляє масивну формулу.
public void RemoveArrayFormula(bool leaveNormalFormula)
Параметри
leaveNormalFormula
bool
True представляє перетворення масивної формули в нормальну формулу.
Replace(string, string, ReplaceOptions)
Замінює текст клітинки з параметрами.
public void Replace(string placeHolder, string newValue, ReplaceOptions options)
Параметри
placeHolder
string
Плейсхолдер клітинки.
newValue
string
Рядкове значення для заміни.
options
ReplaceOptions
Параметри заміни.
SetArrayFormula(string, int, int)
Встановлює масивну формулу (застарілу масивну формулу, введену за допомогою CTRL+SHIFT+ENTER в ms excel) для діапазону клітинок.
public void SetArrayFormula(string arrayFormula, int rowNumber, int columnNumber)
Параметри
arrayFormula
string
Масивна формула.
rowNumber
int
Кількість рядків для заповнення результату масивної формули.
columnNumber
int
Кількість стовпців для заповнення результату масивної формули.
SetArrayFormula(string, int, int, FormulaParseOptions)
Встановлює масивну формулу для діапазону клітинок.
public void SetArrayFormula(string arrayFormula, int rowNumber, int columnNumber, FormulaParseOptions options)
Параметри
arrayFormula
string
Масивна формула.
rowNumber
int
Кількість рядків для заповнення результату масивної формули.
columnNumber
int
Кількість стовпців для заповнення результату масивної формули.
options
FormulaParseOptions
Параметри для розбору формули.
SetArrayFormula(string, int, int, FormulaParseOptions, object[][])
Встановлює масивну формулу для діапазону клітинок.
public void SetArrayFormula(string arrayFormula, int rowNumber, int columnNumber, FormulaParseOptions options, object[][] values)
Параметри
arrayFormula
string
Масивна формула.
rowNumber
int
Кількість рядків для заповнення результату масивної формули.
columnNumber
int
Кількість стовпців для заповнення результату масивної формули.
options
FormulaParseOptions
Параметри для розбору формули.
values
object[][]
значення для тих клітинок з даною масивною формулою.
SetCharacters(FontSetting[])
Встановлює форматування тексту з багатим оформленням для клітинки.
public void SetCharacters(FontSetting[] characters)
Параметри
characters
FontSetting[]
Усі об’єкти Characters.
SetDynamicArrayFormula(string, FormulaParseOptions, bool)
Встановлює динамічну масивну формулу і дозволяє формулі розподілитися по сусідніх клітинках, якщо це можливо.
public CellArea SetDynamicArrayFormula(string arrayFormula, FormulaParseOptions options, bool calculateValue)
Параметри
arrayFormula
string
вираз формули.
options
FormulaParseOptions
параметри для розбору формули. Параметр “Розбір” буде проігноровано, і формула завжди буде розібрана негайно.
calculateValue
bool
чи потрібно обчислювати цю динамічну масивну формулу для тих клітинок у розподіленому діапазоні.
Повертає
діапазон, в який формула повинна розподілитися.
Зауваження
повернутий діапазон може не збігатися з фактичним, в який ця динамічна масивна формула розподіляється. Якщо в діапазоні є непорожні клітинки, формула буде встановлена лише для поточної клітинки і позначена як “#SPILL!”. Але для такої ситуації ми все ще повертаємо весь діапазон, в який ця формула повинна розподілитися.
SetDynamicArrayFormula(string, FormulaParseOptions, object[][], bool, bool)
Встановлює динамічну масивну формулу і дозволяє формулі розподілитися по сусідніх клітинках, якщо це можливо.
public CellArea SetDynamicArrayFormula(string arrayFormula, FormulaParseOptions options, object[][] values, bool calculateRange, bool calculateValue)
Параметри
arrayFormula
string
вираз формули.
options
FormulaParseOptions
параметри для розбору формули. Параметр “Розбір” буде проігноровано, і формула завжди буде розібрана негайно.
values
object[][]
значення (обчислені результати) для тих клітинок з даною динамічною масивною формулою.
calculateRange
bool
Чи потрібно обчислювати розподілений діапазон для цієї динамічної масивної формули. Якщо параметр “значення” не є null і цей прапор є false, то висота розподіленого діапазону буде значення.Length, а ширина - значення[0].Length.
calculateValue
bool
чи потрібно обчислювати цю динамічну масивну формулу для тих клітинок у розподіленому діапазоні, коли “значення” є null або відповідний елемент у “значеннях” для однієї клітинки є null.
Повертає
діапазон, в який формула повинна розподілитися.
Зауваження
повернутий діапазон може не збігатися з фактичним, в який ця динамічна масивна формула розподіляється. Якщо в діапазоні є непорожні клітинки, формула буде встановлена лише для поточної клітинки і позначена як “#SPILL!”. Але для такої ситуації ми все ще повертаємо весь діапазон, в який ця формула повинна розподілитися.
SetDynamicArrayFormula(string, FormulaParseOptions, object[][], bool, bool, CalculationOptions)
Встановлює динамічну масивну формулу і дозволяє формулі розподілитися по сусідніх клітинках, якщо це можливо.
public CellArea SetDynamicArrayFormula(string arrayFormula, FormulaParseOptions options, object[][] values, bool calculateRange, bool calculateValue, CalculationOptions copts)
Параметри
arrayFormula
string
вираз формули.
options
FormulaParseOptions
параметри для розбору формули. Параметр “Розбір” буде проігноровано, і формула завжди буде розібрана негайно.
values
object[][]
значення (обчислені результати) для тих клітинок з даною динамічною масивною формулою.
calculateRange
bool
Чи потрібно обчислювати розподілений діапазон для цієї динамічної масивної формули. Якщо параметр “значення” не є null і цей прапор є false, то висота розподіленого діапазону буде значення.Length, а ширина - значення[0].Length.
calculateValue
bool
чи потрібно обчислювати цю динамічну масивну формулу для тих клітинок у розподіленому діапазоні, коли “значення” є null або відповідний елемент у “значеннях” для однієї клітинки є null.
copts
CalculationOptions
Параметри для обчислення формули. Як правило, з мірку продуктивності, властивість Aspose.Cells.CalculationOptions.Recursive має бути false.
Повертає
діапазон, в який формула повинна розподілитися.
Зауваження
повернутий діапазон може не збігатися з фактичним, в який ця динамічна масивна формула розподіляється. Якщо в діапазоні є непорожні клітинки, формула буде встановлена лише для поточної клітинки і позначена як “#SPILL!”. Але для такої ситуації ми все ще повертаємо весь діапазон, в який ця формула повинна розподілитися.
SetFormula(string, object)
Встановлює формулу та значення (обчислений результат) формули.
public void SetFormula(string formula, object value)
Параметри
formula
string
Формула.
value
object
Значення (обчислений результат) формули.
SetFormula(string, FormulaParseOptions)
Встановлює формулу та значення (обчислений результат) формули.
public void SetFormula(string formula, FormulaParseOptions options)
Параметри
formula
string
Формула.
options
FormulaParseOptions
Параметри для розбору формули.
SetFormula(string, FormulaParseOptions, object)
Встановлює формулу та значення (обчислений результат) формули.
public void SetFormula(string formula, FormulaParseOptions options, object value)
Параметри
formula
string
Формула.
options
FormulaParseOptions
Параметри для розбору формули.
value
object
Значення (обчислений результат) формули.
SetSharedFormula(string, int, int)
Встановлює спільні формули для діапазону клітинок.
public void SetSharedFormula(string sharedFormula, int rowNumber, int columnNumber)
Параметри
sharedFormula
string
Спільна формула.
rowNumber
int
Кількість рядків для заповнення формули.
columnNumber
int
Кількість стовпців для заповнення формули.
SetSharedFormula(string, int, int, FormulaParseOptions)
Встановлює спільні формули для діапазону клітинок.
public void SetSharedFormula(string sharedFormula, int rowNumber, int columnNumber, FormulaParseOptions options)
Параметри
sharedFormula
string
Спільна формула.
rowNumber
int
Кількість рядків для заповнення формули.
columnNumber
int
Кількість стовпців для заповнення формули.
options
FormulaParseOptions
Параметри для розбору формули.
SetSharedFormula(string, int, int, FormulaParseOptions, object[][])
Встановлює спільні формули для діапазону клітинок.
public void SetSharedFormula(string sharedFormula, int rowNumber, int columnNumber, FormulaParseOptions options, object[][] values)
Параметри
sharedFormula
string
Спільна формула.
rowNumber
int
Кількість рядків для заповнення формули.
columnNumber
int
Кількість стовпців для заповнення формули.
options
FormulaParseOptions
Параметри для розбору формули.
values
object[][]
значення для тих клітинок з даною спільною формулою.
SetStyle(Style)
Встановлює стиль клітинки.
public void SetStyle(Style style)
Параметри
style
Style
Стиль клітинки.
Зауваження
Якщо налаштування кордонів змінюються, кордони відрегульованих клітинок також будуть оновлені.
SetStyle(Style, bool)
Застосовує змінену властивість стилю до клітинки.
public void SetStyle(Style style, bool explicitFlag)
Параметри
style
Style
Стиль клітинки.
explicitFlag
bool
True, лише переписуючи форматування, яке явно встановлено.
SetStyle(Style, StyleFlag)
Застосовує стиль клітинки на основі прапорців.
public void SetStyle(Style style, StyleFlag flag)
Параметри
style
Style
Стиль клітинки.
flag
StyleFlag
Прапорець стилю.
SetTableFormula(int, int, string, string, object[][])
Створює двозмінну таблицю даних для даного діапазону, починаючи з цієї клітинки.
public void SetTableFormula(int rowNumber, int columnNumber, string rowInputCell, string columnInputCell, object[][] values)
Параметри
rowNumber
int
Кількість рядків для заповнення формули.
columnNumber
int
Кількість стовпців для заповнення формули.
rowInputCell
string
клітинка для введення рядка.
columnInputCell
string
клітинка для введення стовпця.
values
object[][]
значення для клітинок у діапазоні формули таблиці.
SetTableFormula(int, int, string, bool, object[][])
Створює однозмінну таблицю даних для даного діапазону, починаючи з цієї клітинки.
public void SetTableFormula(int rowNumber, int columnNumber, string inputCell, bool isRowInput, object[][] values)
Параметри
rowNumber
int
Кількість рядків для заповнення формули.
columnNumber
int
Кількість стовпців для заповнення формули.
inputCell
string
вхідна клітинка.
isRowInput
bool
Вказує, чи є вхідна клітинка клітинкою для введення рядка (true) або клітинкою для введення стовпця (false).
values
object[][]
значення для клітинок у діапазоні формули таблиці.
SetTableFormula(int, int, int, int, int, int, object[][])
Створює двозмінну таблицю даних для даного діапазону, починаючи з цієї клітинки.
public void SetTableFormula(int rowNumber, int columnNumber, int rowIndexOfRowInputCell, int columnIndexOfRowInputCell, int rowIndexOfColumnInputCell, int columnIndexOfColumnInputCell, object[][] values)
Параметри
rowNumber
int
Кількість рядків для заповнення формули.
columnNumber
int
Кількість стовпців для заповнення формули.
rowIndexOfRowInputCell
int
індекс рядка клітинки для введення рядка.
columnIndexOfRowInputCell
int
індекс стовпця клітинки для введення рядка.
rowIndexOfColumnInputCell
int
індекс рядка клітинки для введення стовпця.
columnIndexOfColumnInputCell
int
індекс стовпця клітинки для введення стовпця.
values
object[][]
значення для клітинок у діапазоні формули таблиці.
SetTableFormula(int, int, int, int, bool, object[][])
Створює однозмінну таблицю даних для даного діапазону, починаючи з цієї клітинки.
public void SetTableFormula(int rowNumber, int columnNumber, int rowIndexOfInputCell, int columnIndexOfInputCell, bool isRowInput, object[][] values)
Параметри
rowNumber
int
Кількість рядків для заповнення формули.
columnNumber
int
Кількість стовпців для заповнення формули.
rowIndexOfInputCell
int
індекс рядка вхідної клітинки.
columnIndexOfInputCell
int
індекс стовпця вхідної клітинки.
isRowInput
bool
Вказує, чи є вхідна клітинка клітинкою для введення рядка (true) або клітинкою для введення стовпця (false).
values
object[][]
значення для клітинок у діапазоні формули таблиці.
ToJson()
Конвертує Aspose.Cells.Cell в JSON структуровані дані.
public string ToJson()
Повертає
ToString()
Повертає рядок, що представляє поточний об’єкт Cell.
public override string ToString()