Class Cell

Class Cell

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

Інкапсулює об’єкт, який представляє одну клітинку Workbook.

public class Cell

Спадкування

objectCell

Спадковані члени

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; }

Значення властивості

bool

Column

Отримує номер стовпця (нульовий) клітинки.

public int Column { get; }

Значення властивості

int

Comment

Отримує коментар цієї клітинки.

public Comment Comment { get; }

Значення властивості

Comment

Зауваження

Якщо для клітинки немає коментаря, повертає null.

ContainsExternalLink

Вказує, чи містить ця клітинка зовнішнє посилання. Застосовується лише тоді, коли клітинка є формульною.

public bool ContainsExternalLink { get; }

Значення властивості

bool

DateTimeValue

Отримує значення DateTime, що міститься у клітинці.

public DateTime DateTimeValue { get; }

Значення властивості

DateTime

DisplayStringValue

Отримує відформатоване рядкове значення цієї клітинки відповідно до стилю відображення клітинки.

public string DisplayStringValue { get; }

Значення властивості

string

DoubleValue

Отримує дробове значення, що міститься у клітинці.

public double DoubleValue { get; }

Значення властивості

double

EmbeddedImage

Отримує та встановлює вбудоване зображення у клітинці.

public byte[] EmbeddedImage { get; set; }

Значення властивості

byte[]

FloatValue

Отримує значення з плаваючою комою, що міститься у клітинці.

public float FloatValue { get; }

Значення властивості

float

Formula

Отримує або встановлює формулу Aspose.Cells.Cell.

public string Formula { get; set; }

Значення властивості

string

Приклади

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; }

Значення властивості

string

HasCustomStyle

Вказує, чи має ця клітинка налаштування стилю, відмінні від стандартного, успадкованого від відповідного рядка, стовпця або книги.

public bool HasCustomStyle { get; }

Значення властивості

bool

HtmlString

Отримує та встановлює html рядок, який містить дані та деякі формати в цій клітинці.

public string HtmlString { get; set; }

Значення властивості

string

IntValue

Отримує ціле значення, що міститься у клітинці.

public int IntValue { get; }

Значення властивості

int

IsArrayFormula

Вказує, чи є формула клітинки масивною формулою.

public bool IsArrayFormula { get; }

Значення властивості

bool

IsArrayHeader

Вказує, що формула клітинки є масивною формулою і це перша клітинка масиву.

public bool IsArrayHeader { get; }

Значення властивості

bool

IsCheckBoxStyle

Вказує, чи є ця клітинка стилем прапорця.

public bool IsCheckBoxStyle { get; set; }

Значення властивості

bool

IsDynamicArrayFormula

Вказує, чи є формула клітинки динамічною масивною формулою (true) або застарілою масивною формулою (false).

public bool IsDynamicArrayFormula { get; }

Значення властивості

bool

IsErrorValue

Перевіряє, чи є значення цієї клітинки помилкою.

public bool IsErrorValue { get; }

Значення властивості

bool

Зауваження

Також застосовується до формульної клітинки, щоб перевірити, чи є обчислений результат помилкою.

IsFormula

Представляє, чи містить вказана клітинка формулу.

public bool IsFormula { get; }

Значення властивості

bool

IsMerged

Перевіряє, чи є клітинка частиною злитого діапазону.

public bool IsMerged { get; }

Значення властивості

bool

IsNumericValue

Вказує, чи є значення цієї клітинки числовим (int, double та datetime)

public bool IsNumericValue { get; }

Значення властивості

bool

Зауваження

Також застосовується до формульної клітинки, щоб перевірити обчислений результат.

IsSharedFormula

Вказує, чи є формула клітинки частиною спільної формули.

public bool IsSharedFormula { get; }

Значення властивості

bool

IsStyleSet

Вказує, чи встановлено стиль клітинки. Якщо повертає false, це означає, що ця клітинка має стандартний формат клітинки.

public bool IsStyleSet { get; }

Значення властивості

bool

IsTableFormula

Вказує, чи є ця клітинка частиною формули таблиці.

public bool IsTableFormula { get; }

Значення властивості

bool

Name

Отримує ім’я клітинки.

public string Name { get; }

Значення властивості

string

Зауваження

Ім’я клітинки включає літеру стовпця та номер рядка. Наприклад, ім’я клітинки в рядку 0 та стовпці 0 - це A1.

NumberCategoryType

Представляє тип категорії форматування числа цієї клітинки.

public NumberCategoryType NumberCategoryType { get; }

Значення властивості

NumberCategoryType

Зауваження

Коли шаблон форматування клітинки поєднується з умовними шаблонами форматування, повернутий тип відповідає частині, що використовується для поточного значення цієї клітинки. Наприклад, якщо шаблон форматування для цієї клітинки “#,##0;(#,##0);”-";@", тоді, коли значення клітинки є числовим і не 0, повернений тип - Aspose.Cells.NumberCategoryType.Number; Коли значення клітинки є 0 або нечисловим значенням, повернений тип - Aspose.Cells.NumberCategoryType.Text.

R1C1Formula

Отримує або встановлює R1C1 формулу Aspose.Cells.Cell.

public string R1C1Formula { get; set; }

Значення властивості

string

Row

Отримує номер рядка (нульовий) клітинки.

public int Row { get; }

Значення властивості

int

SharedStyleIndex

Отримує індекс спільного стилю клітинки в пулі стилів.

public int SharedStyleIndex { get; }

Значення властивості

int

StringValue

Отримує рядкове значення, що міститься у клітинці. Якщо тип цієї клітинки - рядок, то повертається саме рядкове значення. Для інших типів клітинок буде повернено відформатоване рядкове значення (відформатоване відповідно до вказаного стилю цієї клітинки). Відформатоване значення клітинки таке ж, як те, що ви можете отримати з excel, копіюючи клітинку як текст (наприклад, копіюючи клітинку в текстовий редактор або експортування в csv).

public string StringValue { get; }

Значення властивості

string

Type

Представляє тип значення клітинки.

public CellValueType Type { get; }

Значення властивості

CellValueType

Value

Отримує/встановлює значення, що міститься у цій клітинці.

public object Value { get; set; }

Значення властивості

object

Зауваження

Можливі типи:

null,

Boolean,

DateTime,

Double,

Integer

String.

Для значення int воно може бути повернуте як об’єкт Integer або об’єкт Double. І немає гарантії, що повернуте значення завжди буде зберігатися як той самий тип об’єкта.

Worksheet

Отримує батьківський аркуш.

public Worksheet Worksheet { get; }

Значення властивості

Worksheet

Методи

Calculate(CalculationOptions)

Обчислює формулу клітинки.

public void Calculate(CalculationOptions options)

Параметри

options CalculationOptions

Параметри для обчислення

Characters(int, int)

Повертає об’єкт Characters, який представляє діапазон символів у тексті клітинки.

public FontSetting Characters(int startIndex, int length)

Параметри

startIndex int

Індекс початку символу.

length int

Кількість символів.

Повертає

FontSetting

Об’єкт 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

інший об’єкт

Повертає

bool

true, якщо два об’єкти посилаються на ту ж клітинку.

Equals(Cell)

Перевіряє, чи цей об’єкт посилається на ту ж клітинку, що й інший об’єкт клітинки.

public bool Equals(Cell cell)

Параметри

cell Cell

інший об’єкт клітинки

Повертає

bool

true, якщо два об’єкти клітинки посилаються на ту ж клітинку.

GetArrayRange()

Отримує діапазон масиву, якщо формула клітинки є масивною формулою.

public CellArea GetArrayRange()

Повертає

CellArea

Діапазон масиву.

Зауваження

Застосовується лише, якщо формула клітинки є масивною формулою.

GetCharacters()

Повертає всі об’єкти Characters які представляють діапазон символів у тексті клітинки.

public FontSetting[] GetCharacters()

Повертає

FontSetting[]

Усі об’єкти Characters.

GetCharacters(bool)

Повертає всі об’єкти Characters які представляють діапазон символів у тексті клітинки.

public FontSetting[] GetCharacters(bool flag)

Параметри

flag bool

Вказує, чи застосовувати стиль таблиці до клітинки, якщо клітинка знаходиться в таблиці.

Повертає

FontSetting[]

Усі об’єкти Characters.

GetConditionalFormattingResult()

Отримує результат умовного форматування.

public ConditionalFormattingResult GetConditionalFormattingResult()

Повертає

ConditionalFormattingResult

Зауваження

Повертає 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

Чи повертає ті залежності, які не посилаються на цю клітинку безпосередньо, але посилаються на інші елементи цієї клітинки.

Повертає

IEnumerator

Перерахувач для перерахунку всіх залежностей (об’єктів 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()

Повертає

Style

GetDisplayStyle(bool)

Отримує стиль відображення клітинки. Якщо клітинка має умовне форматування, стиль відображення не буде таким же, як cell.GetStyle().

public Style GetDisplayStyle(bool includeMergedBorders)

Параметри

includeMergedBorders bool

Вказує, чи перевіряти кордони злитих клітинок.

Повертає

Style

GetFormatConditions()

Отримує умови форматування, які застосовуються до цієї клітинки.

public FormatConditionCollection[] GetFormatConditions()

Повертає

FormatConditionCollection[]

Повертає об’єкт Aspose.Cells.FormatConditionCollection.

GetFormula(bool, bool)

Отримує формулу цієї клітинки.

public string GetFormula(bool isR1C1, bool isLocal)

Параметри

isR1C1 bool

Чи потрібно форматувати формулу як R1C1.

isLocal bool

Чи потрібно форматувати формулу за локаллю.

Повертає

string

формула цієї клітинки.

GetHashCode()

Служить як хеш-функція для певного типу.

public override int GetHashCode()

Повертає

int

Хеш-код для поточного об’єкта Cell.

GetHeightOfValue()

Отримує висоту значення в одиницях пікселів.

public int GetHeightOfValue()

Повертає

int

GetHtmlString(bool)

Отримує html рядок, який містить дані та деякі формати в цій клітинці.

public string GetHtmlString(bool html5)

Параметри

html5 bool

Вказує, чи значення сумісне з html5.

Повертає

string

GetMergedRange()

Повертає об’єкт Aspose.Cells.Range, який представляє злитий діапазон.

public Range GetMergedRange()

Повертає

Range

Об’єкт Aspose.Cells.Range. Null, якщо ця клітинка не злитий.

GetPrecedents()

Отримує всі посилання, що з’являються у формулі цієї клітинки.

public ReferredAreaCollection GetPrecedents()

Повертає

ReferredAreaCollection

Колекція всіх посилань, що з’являються у формулі цієї клітинки.

Приклади

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()

Повертає

IEnumerator

Перерахувач для перерахунку всіх посилань (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()

Повертає

CellRichValue

GetStringValue(CellValueFormatStrategy)

Отримує рядкове значення за специфічною форматовою стратегією.

public string GetStringValue(CellValueFormatStrategy formatStrategy)

Параметри

formatStrategy CellValueFormatStrategy

Форматна стратегія.

Повертає

string

GetStyle()

Отримує стиль клітинки.

public Style GetStyle()

Повертає

Style

Об’єкт стилю.

Зауваження

Щоб змінити стиль клітинки, будь ласка, викликайте метод Cell.SetStyle() після модифікації повернутого об’єкта стилю. Цей метод є тим же, що і Aspose.Cells.Cell.GetStyle(System.Boolean) з true значенням для параметра.

GetStyle(bool)

Якщо checkBorders є true, перевіряє, чи впливають кордони інших клітинок на стиль цієї клітинки.

public Style GetStyle(bool checkBorders)

Параметри

checkBorders bool

Перевіряє кордони інших клітинок.

Повертає

Style

Об’єкт стилю.

GetTable()

Отримує таблицю, яка містить цю клітинку.

public ListObject GetTable()

Повертає

ListObject

GetValidation()

Отримує перевірку, застосовану до цієї клітинки.

public Validation GetValidation()

Повертає

Validation

GetValidationValue()

Отримує значення перевірки, яке застосоване до цієї клітинки.

public bool GetValidationValue()

Повертає

bool

GetWidthOfValue()

Отримує ширину значення в одиницях пікселів.

public int GetWidthOfValue()

Повертає

int

InsertText(int, string)

Вставляє кілька символів у клітинку. Якщо клітинка має багатоформатне оформлення, цей метод може зберегти оригінальне форматування.

public void InsertText(int index, string text)

Параметри

index int

Індекс.

text string

Вставлений текст.

IsRichText()

Вказує, чи є рядкове значення цієї клітинки текстом з багатим форматуванням.

public bool IsRichText()

Повертає

bool

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

чи потрібно обчислювати цю динамічну масивну формулу для тих клітинок у розподіленому діапазоні.

Повертає

CellArea

діапазон, в який формула повинна розподілитися.

Зауваження

повернутий діапазон може не збігатися з фактичним, в який ця динамічна масивна формула розподіляється. Якщо в діапазоні є непорожні клітинки, формула буде встановлена лише для поточної клітинки і позначена як “#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.

Повертає

CellArea

діапазон, в який формула повинна розподілитися.

Зауваження

повернутий діапазон може не збігатися з фактичним, в який ця динамічна масивна формула розподіляється. Якщо в діапазоні є непорожні клітинки, формула буде встановлена лише для поточної клітинки і позначена як “#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.

Повертає

CellArea

діапазон, в який формула повинна розподілитися.

Зауваження

повернутий діапазон може не збігатися з фактичним, в який ця динамічна масивна формула розподіляється. Якщо в діапазоні є непорожні клітинки, формула буде встановлена лише для поточної клітинки і позначена як “#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()

Повертає

string

ToString()

Повертає рядок, що представляє поточний об’єкт Cell.

public override string ToString()

Повертає

string

 Українська