Cell

Cell class

Инкапсулирует объект, представляющий одну ячейку книги.

public class Cell

Характеристики

ИмяОписание
BoolValue { get; }Получает логическое значение, содержащееся в ячейке.
Column { get; }Получает номер столбца (начиная с нуля) ячейки.
Comment { get; }Получает комментарий этой ячейки.
ContainsExternalLink { get; }Указывает, содержит ли эта ячейка внешнюю ссылку. Применяется только в том случае, если ячейка является ячейкой формулы.
DateTimeValue { get; }Получает значение DateTime, содержащееся в ячейке.
DisplayStringValue { get; }Получает отформатированное строковое значение этой ячейки по стилю отображения ячейки.
DoubleValue { get; }Получает двойное значение, содержащееся в ячейке.
FloatValue { get; }Получает значение с плавающей запятой, содержащееся в ячейке.
Formula { get; set; }Получает или задает формулуCell .
FormulaLocal { get; set; }Получить формулу ячейки в формате локали.
HtmlString { get; set; }Получает и задает строку html, содержащую данные и некоторые форматы в этой ячейке.
IntValue { get; }Получает целочисленное значение, содержащееся в ячейке.
IsArrayFormula { get; }Указывает, является ли формула ячейки формулой массива.
IsArrayHeader { get; }Указывает, что формула ячейки и формула массива и это первая ячейка массива.
IsErrorValue { get; }Проверяет, является ли значение этой ячейки ошибкой.
IsFormula { get; }Указывает, содержит ли указанная ячейка формулу.
IsMerged { get; }Проверяет, является ли ячейка частью объединенного диапазона или нет.
IsNumericValue { get; }Указывает, является ли внутреннее значение этой ячейки числовым (int, double и datetime)
IsSharedFormula { get; }Указывает, является ли формула ячейки частью общей формулы.
IsStyleSet { get; }Указывает, установлен ли стиль ячейки. Если возвращается false, это означает, что эта ячейка имеет формат ячейки по умолчанию.
IsTableFormula { get; }Указывает, является ли эта ячейка частью формулы таблицы.
Name { get; }Получает имя ячейки.
NumberCategoryType { get; }Представляет тип категории числового форматирования этой ячейки.
R1C1Formula { get; set; }Получает или задает формулу R1C1 дляCell .
Row { get; }Получает номер строки (начиная с нуля) ячейки.
SharedStyleIndex { get; }Получает общий индекс стиля ячейки в пуле стилей.
StringValue { get; }Получает строковое значение, содержащееся в ячейке. Если тип этой ячейки — строка, верните само строковое значение. Для других типов ячеек будет возвращено форматированное строковое значение (отформатированное в соответствии с указанным стилем этой ячейки). Форматированное значение ячейки совпадает с тем, что вы может получить из excel при копировании ячейки как текста (например, копирование ячейки в текстовый редактор или экспорт в csv).
Type { get; }Представляет тип значения ячейки.
Value { get; set; }Получает значение, содержащееся в этой ячейке.
Worksheet { get; }Получает родительский рабочий лист.

Методы

ИмяОписание
Calculate(CalculationOptions)Вычисляет формулу ячейки.
Characters(int, int)Возвращает объект символов, представляющий диапазон символов в тексте ячейки.
Copy(Cell)Копирует данные из исходной ячейки.
Equals(Cell)Проверяет, ссылается ли этот объект на ту же ячейку с другим объектом ячейки.
override Equals(object)Проверяет, ссылается ли этот объект на ту же ячейку с другим.
GetArrayRange()Получает диапазон массива, если формула ячейки является формулой массива.
GetCharacters()Возвращает все объекты символов , представляющие диапазон символов в тексте ячейки.
GetCharacters(bool)Возвращает все объекты символов , представляющие диапазон символов в тексте ячейки.
GetConditionalFormattingResult()Получить результат условного форматирования.
GetDependents(bool)Получить все ячейки, формула которых напрямую ссылается на эту ячейку.
GetDependentsInCalculation(bool)Получает все ячейки, расчетный результат которых зависит от этой ячейки.
GetDisplayStyle()Получает стиль отображения ячейки. Если на эту ячейку также влияют другие настройки, такие как условное форматирование, объекты списка и т. д., тогда стиль отображения может отличаться от стиля cell.GetStyle().
GetDisplayStyle(bool)Получает стиль отображения ячейки. Если ячейка имеет условное форматирование, стиль отображения не совпадает со стилем отображения ячейки.GetStyle().
GetFormatConditions()Получает условия формата, применимые к этой ячейке.
GetFormula(bool, bool)Получить формулу этой ячейки.
override GetHashCode()Служит хеш-функцией для определенного типа.
GetHeightOfValue()Получает высоту значения в пикселях.
GetHtmlString(bool)Получает строку html, содержащую данные и некоторые форматы в этой ячейке.
GetMergedRange()ВозвращаетRange объект, представляющий объединенный диапазон.
GetPrecedents()Получает все ссылки, встречающиеся в формуле этой ячейки.
GetPrecedentsInCalculation()Получает все прецеденты (ссылки на ячейки в текущей книге), используемые формулой этой ячейки при ее вычислении.
GetStringValue(CellValueFormatStrategy)Получает строковое значение по определенной отформатированной стратегии.
GetStyle()Получает стиль ячейки.
GetStyle(bool)Если для checkBorders установлено значение true, проверьте, повлияют ли границы других ячеек на стиль этой ячейки.
GetTable()Получает таблицу, содержащую эту ячейку.
GetValidation()Получает проверку, примененную к этой ячейке.
GetValidationValue()Получает значение проверки, примененное к этой ячейке.
GetWidthOfValue()Получает ширину значения в пикселях.
IsRichText()Указывает, является ли значение строки ячейки форматированным текстом.
PutValue(bool)Помещает логическое значение в ячейку.
PutValue(DateTime)Помещает значение DateTime в ячейку.
PutValue(double)Помещает в ячейку двойное значение.
PutValue(int)Помещает в ячейку целочисленное значение.
PutValue(object)Помещает значение объекта в ячейку.
PutValue(string)Помещает строковое значение в ячейку.
PutValue(string, bool)Помещает строковое значение в ячейку и при необходимости преобразует значение в другой тип данных.
PutValue(string, bool, bool)Помещает значение в ячейку, при необходимости значение будет преобразовано в другой тип данных, а числовой формат ячейки будет сброшен.
RemoveArrayFormula(bool)Удалить формулу массива.
SetArrayFormula(string, int, int)Задает формулу массива (устаревшая формула массива, введенная с помощью CTRL+SHIFT+ENTER в MS Excel) для диапазона ячеек.
SetArrayFormula(string, int, int, FormulaParseOptions)Задает формулу массива для диапазона ячеек.
SetArrayFormula(string, int, int, FormulaParseOptions, object[][])Задает формулу массива для диапазона ячеек.
SetCharacters(FontSetting[])Устанавливает расширенный текстовый формат ячейки.
SetDynamicArrayFormula(string, FormulaParseOptions, bool)Устанавливает формулу динамического массива и по возможности распространяет формулу на соседние ячейки.
SetDynamicArrayFormula(string, FormulaParseOptions, object[][], bool, bool)Устанавливает формулу динамического массива и по возможности распространяет формулу на соседние ячейки.
SetFormula(string, object)Установить формулу и значение формулы.
SetFormula(string, FormulaParseOptions, object)Установить формулу и значение формулы.
SetSharedFormula(string, int, int)Задает формулу для диапазона ячеек.
SetSharedFormula(string, int, int, FormulaParseOptions)Задает формулу для диапазона ячеек.
SetSharedFormula(string, int, int, FormulaParseOptions, object[][])Задает формулу для диапазона ячеек.
SetStyle(Style)Устанавливает стиль ячейки.
SetStyle(Style, bool)Применить стиль ячейки.
SetStyle(Style, StyleFlag)Применить стиль ячейки.
override ToString()Возвращает строку, представляющую текущий объект Cell.

Примеры

[C#]

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

// Помещаем строку в ячейку
Cell cell = cells[0, 0];
cell.PutValue("Hello");

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

// Поместите комбинированную формулу: «сумма (среднее (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);



[Visual Basic]

Dim excel as Workbook = new Workbook()
Dim cells as Cells = exce.Worksheets(0).Cells

'Поместите строку в ячейку
Dim cell as Cell = cells(0, 0)
cell.PutValue("Hello")

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"

// Поместите комбинированную формулу: «сумма (среднее (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)

Смотрите также