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 and 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) 返回一个 Characters 对象,该对象表示单元格文本中的一系列字符。
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为真,检查其他单元格的边框是否会影响本单元格的样式
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) 将数组公式(在 ms excel 中通过 CTRL+SHIFT+ENTER 输入的旧数组公式)设置为一系列单元格。
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;

//将一个double放入一个单元格中
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);



[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

//将一个double放入一个单元格中
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)

也可以看看