Class Cell
Namespace: Aspose.Cells
Assembly: Aspose.Cells.dll (25.2.0)
Đóng gói đối tượng đại diện cho một ô Workbook đơn lẻ.
public class Cell
Kế thừa
Các thành viên kế thừa
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Ví dụ
Workbook excel = new Workbook();
Cells cells = excel.Worksheets[0].Cells;
//Đưa một chuỗi vào ô
Cell cell = cells[0, 0];
cell.PutValue("Hello");
string first = cell.StringValue;
//Đưa một số nguyên vào ô
cell = cells["B1"];
cell.PutValue(12);
int second = cell.IntValue;
//Đưa một số thực vào ô
cell = cells[0, 2];
cell.PutValue(-1.234);
double third = cell.DoubleValue;
//Đưa một công thức vào ô
cell = cells["D1"];
cell.Formula = "=B1 + C1";
//Đưa một công thức kết hợp: "sum(average(b1,c1), b1)" vào ô b2
cell = cells["b2"];
cell.Formula = "=sum(average(b1,c1), b1)";
//Đặt kiểu cho một ô
Style style = cell.GetStyle();
//Đặt màu nền
style.BackgroundColor = Color.Yellow;
//Đặt định dạng cho một ô
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
'Đưa một chuỗi vào ô
Dim cell as Cell = cells(0, 0)
cell.PutValue("Hello")
Dim first as String = cell.StringValue
'Đưa một số nguyên vào ô
cell = cells("B1")
cell.PutValue(12)
Dim second as Integer = cell.IntValue
'Đưa một số thực vào ô
cell = cells(0, 2)
cell.PutValue(-1.234)
Dim third as Double = cell.DoubleValue
'Đưa một công thức vào ô
cell = cells("D1")
cell.Formula = "=B1 + C1"
'Đưa một công thức kết hợp: "sum(average(b1,c1), b1)" vào ô b2
cell = cells("b2")
cell.Formula = "=sum(average(b1,c1), b1)"
'Đặt kiểu cho một ô
Dim style as Style = cell.GetStyle()
'Đặt màu nền
style.BackgroundColor = Color.Yellow
'Đặt phông chữ cho một ô
style.Font.Name = "Courier New"
style.VerticalAlignment = TextAlignmentType.Top
cell.SetStyle(style)
Thuộc tính
BoolValue
Lấy giá trị boolean chứa trong ô.
public bool BoolValue { get; }
Giá trị thuộc tính
Column
Lấy số cột (bắt đầu từ 0) của ô.
public int Column { get; }
Giá trị thuộc tính
Comment
Lấy chú thích của ô này.
public Comment Comment { get; }
Giá trị thuộc tính
Nhận xét
Nếu không có chú thích nào áp dụng cho ô, trả về null.
ContainsExternalLink
Chỉ ra liệu ô này có chứa liên kết bên ngoài hay không. Chỉ áp dụng khi ô là ô công thức.
public bool ContainsExternalLink { get; }
Giá trị thuộc tính
DateTimeValue
Lấy giá trị DateTime chứa trong ô.
public DateTime DateTimeValue { get; }
Giá trị thuộc tính
DisplayStringValue
Lấy giá trị chuỗi định dạng của ô này theo kiểu hiển thị của ô.
public string DisplayStringValue { get; }
Giá trị thuộc tính
DoubleValue
Lấy giá trị double chứa trong ô.
public double DoubleValue { get; }
Giá trị thuộc tính
EmbeddedImage
Lấy và thiết lập hình ảnh nhúng trong ô.
public byte[] EmbeddedImage { get; set; }
Giá trị thuộc tính
byte[]
FloatValue
Lấy giá trị float chứa trong ô.
public float FloatValue { get; }
Giá trị thuộc tính
Formula
Lấy hoặc thiết lập một công thức của Aspose.Cells.Cell.
public string Formula { get; set; }
Giá trị thuộc tính
Ví dụ
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"
Nhận xét
Chuỗi công thức luôn bắt đầu bằng dấu “=”. Và vui lòng luôn sử dụng dấu phẩy(,) làm dấu phân cách tham số, chẳng hạn như “=SUM(A1, E1, H2)”.
FormulaLocal
Lấy công thức được định dạng theo ngôn ngữ của ô.
public string FormulaLocal { get; set; }
Giá trị thuộc tính
HasCustomStyle
Chỉ ra liệu ô này có cài đặt kiểu tùy chỉnh (khác với kiểu mặc định được kế thừa từ hàng, cột hoặc workbook tương ứng) hay không.
public bool HasCustomStyle { get; }
Giá trị thuộc tính
HtmlString
Lấy và thiết lập chuỗi html chứa dữ liệu và một số định dạng trong ô này.
public string HtmlString { get; set; }
Giá trị thuộc tính
IntValue
Lấy giá trị số nguyên chứa trong ô.
public int IntValue { get; }
Giá trị thuộc tính
IsArrayFormula
Chỉ ra liệu công thức của ô có phải là công thức mảng hay không.
public bool IsArrayFormula { get; }
Giá trị thuộc tính
IsArrayHeader
Chỉ ra công thức của ô là công thức mảng và nó là ô đầu tiên của mảng.
public bool IsArrayHeader { get; }
Giá trị thuộc tính
IsCheckBoxStyle
Chỉ ra liệu ô này có được thiết lập như một ô kiểm hay không.
public bool IsCheckBoxStyle { get; set; }
Giá trị thuộc tính
IsDynamicArrayFormula
Chỉ ra liệu công thức của ô là công thức mảng động (true) hay công thức mảng cổ điển (false).
public bool IsDynamicArrayFormula { get; }
Giá trị thuộc tính
IsErrorValue
Kiểm tra xem giá trị của ô này có phải là lỗi hay không.
public bool IsErrorValue { get; }
Giá trị thuộc tính
Nhận xét
Cũng áp dụng cho ô công thức để kiểm tra xem kết quả tính toán có phải là lỗi hay không.
IsFormula
Đại diện cho việc ô được chỉ định có chứa công thức hay không.
public bool IsFormula { get; }
Giá trị thuộc tính
IsMerged
Kiểm tra xem một ô có phải là một phần của một vùng đã hợp nhất hay không.
public bool IsMerged { get; }
Giá trị thuộc tính
IsNumericValue
Chỉ ra liệu giá trị của ô này có phải là số (int, double và datetime) hay không.
public bool IsNumericValue { get; }
Giá trị thuộc tính
Nhận xét
Cũng áp dụng cho ô công thức để kiểm tra kết quả tính toán.
IsSharedFormula
Chỉ ra liệu công thức của ô có phải là một phần của công thức chia sẻ hay không.
public bool IsSharedFormula { get; }
Giá trị thuộc tính
IsStyleSet
Chỉ ra liệu kiểu của ô đã được thiết lập. Nếu trả về false, điều đó có nghĩa là ô này có định dạng ô mặc định.
public bool IsStyleSet { get; }
Giá trị thuộc tính
IsTableFormula
Chỉ ra liệu ô này có phải là một phần của công thức bảng hay không.
public bool IsTableFormula { get; }
Giá trị thuộc tính
Name
Lấy tên của ô.
public string Name { get; }
Giá trị thuộc tính
Nhận xét
Tên ô bao gồm chữ cái cột và số hàng của nó. Ví dụ, tên của một ô ở hàng 0 và cột 0 là A1.
NumberCategoryType
Đại diện cho loại danh mục của định dạng số của ô này.
public NumberCategoryType NumberCategoryType { get; }
Giá trị thuộc tính
Nhận xét
Khi mẫu định dạng của ô được kết hợp với các mẫu định dạng điều kiện, thì loại trả về tương ứng với phần được sử dụng cho giá trị hiện tại của ô này. Ví dụ, nếu mẫu định dạng cho ô này là “#,##0;(#,##0);”-";@", thì khi giá trị của ô là số và không phải 0, loại trả về là Aspose.Cells.NumberCategoryType.Number; Khi giá trị của ô là 0 hoặc không phải giá trị số, loại trả về là Aspose.Cells.NumberCategoryType.Text.
R1C1Formula
Lấy hoặc thiết lập một công thức R1C1 của Aspose.Cells.Cell.
public string R1C1Formula { get; set; }
Giá trị thuộc tính
Row
Lấy số hàng (bắt đầu từ 0) của ô.
public int Row { get; }
Giá trị thuộc tính
SharedStyleIndex
Lấy chỉ số kiểu chia sẻ của ô trong nhóm kiểu.
public int SharedStyleIndex { get; }
Giá trị thuộc tính
StringValue
Lấy giá trị chuỗi chứa trong ô. Nếu loại của ô này là chuỗi, thì trả về giá trị chuỗi đó. Đối với các loại ô khác, giá trị chuỗi đã được định dạng (định dạng với kiểu đã chỉ định của ô này) sẽ được trả về. Giá trị ô đã được định dạng giống với những gì bạn có thể nhận được từ excel khi sao chép một ô dưới dạng văn bản (như sao chép ô vào trình soạn thảo văn bản hoặc xuất sang csv).
public string StringValue { get; }
Giá trị thuộc tính
Type
Đại diện cho loại giá trị của ô.
public CellValueType Type { get; }
Giá trị thuộc tính
Value
Lấy/thiết lập giá trị chứa trong ô này.
public object Value { get; set; }
Giá trị thuộc tính
Nhận xét
Các loại có thể:
null,
Boolean,
DateTime,
Double,
Integer
String.
Đối với giá trị int, nó có thể được trả về dưới dạng đối tượng Integer hoặc đối tượng Double. Và không có đảm bảo rằng giá trị trả về sẽ được giữ lại dưới dạng cùng một loại đối tượng luôn luôn.Worksheet
Lấy bảng tính cha.
public Worksheet Worksheet { get; }
Giá trị thuộc tính
Phương thức
Calculate(CalculationOptions)
Tính toán công thức của ô.
public void Calculate(CalculationOptions options)
Tham số
options
CalculationOptions
Tùy chọn cho việc tính toán
Characters(int, int)
Trả về một đối tượng Characters đại diện cho một phạm vi ký tự trong văn bản ô.
public FontSetting Characters(int startIndex, int length)
Tham số
startIndex
int
Chỉ số bắt đầu của ký tự.
length
int
Số lượng ký tự.
Trả về
Đối tượng Characters.
Ví dụ
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
Nhận xét
Phương thức này chỉ hoạt động trên ô có giá trị chuỗi.
Copy(Cell)
Sao chép dữ liệu từ một ô nguồn.
public void Copy(Cell cell)
Tham số
cell
Cell
Đối tượng Aspose.Cells.Cell nguồn.
Equals(object)
Kiểm tra xem đối tượng này có tham chiếu đến cùng một ô với đối tượng khác hay không.
public override bool Equals(object obj)
Tham số
obj
object
đối tượng khác
Trả về
true nếu hai đối tượng tham chiếu đến cùng một ô.
Equals(Cell)
Kiểm tra xem đối tượng này có tham chiếu đến cùng một ô với đối tượng ô khác hay không.
public bool Equals(Cell cell)
Tham số
cell
Cell
đối tượng ô khác
Trả về
true nếu hai đối tượng ô tham chiếu đến cùng một ô.
GetArrayRange()
Lấy phạm vi mảng nếu công thức của ô là công thức mảng.
public CellArea GetArrayRange()
Trả về
Phạm vi mảng.
Nhận xét
Chỉ áp dụng khi công thức của ô là công thức mảng.
GetCharacters()
Trả về tất cả các đối tượng Characters đại diện cho một phạm vi ký tự trong văn bản ô.
public FontSetting[] GetCharacters()
Trả về
Tất cả các đối tượng Characters.
GetCharacters(bool)
Trả về tất cả các đối tượng Characters đại diện cho một phạm vi ký tự trong văn bản ô.
public FontSetting[] GetCharacters(bool flag)
Tham số
flag
bool
Chỉ ra liệu có áp dụng kiểu bảng cho ô nếu ô nằm trong bảng hay không.
Trả về
Tất cả các đối tượng Characters.
GetConditionalFormattingResult()
Lấy kết quả của định dạng điều kiện.
public ConditionalFormattingResult GetConditionalFormattingResult()
Trả về
Nhận xét
Trả về null nếu không có định dạng điều kiện nào được áp dụng cho ô này.
GetDependents(bool)
Lấy tất cả các ô mà công thức tham chiếu đến ô này trực tiếp.
public Cell[] GetDependents(bool isAll)
Tham số
isAll
bool
Chỉ ra liệu có kiểm tra công thức trong các bảng tính khác hay không.
Trả về
Cell[]
Ví dụ
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);
}
Nhận xét
- Nếu một tham chiếu chứa ô này xuất hiện trong công thức của một ô, ô đó sẽ được coi là phụ thuộc vào ô này, bất kể tham chiếu hoặc ô này có được sử dụng hay không trong quá trình tính toán. Ví dụ, mặc dù ô A2 trong công thức "=IF(TRUE,A1,A2)" không được sử dụng trong quá trình tính toán, công thức này vẫn được coi là phụ thuộc vào A2.
- Để lấy những công thức mà kết quả tính toán phụ thuộc vào ô này, vui lòng sử dụng Aspose.Cells.Cell.GetDependentsInCalculation(System.Boolean).
- Khi theo dõi các phụ thuộc cho một ô, tất cả các công thức trong workbook hoặc worksheet sẽ được phân tích và kiểm tra. Vì vậy, đây là một quá trình tốn thời gian. Nếu người dùng cần theo dõi các phụ thuộc cho nhiều ô, việc sử dụng phương thức này sẽ gây ra hiệu suất kém. Vì lý do hiệu suất, người dùng nên sử dụng Aspose.Cells.Cell.GetDependentsInCalculation(System.Boolean) thay thế. Hoặc, người dùng có thể thu thập bản đồ các ô trước đó của tất cả các ô bằng Aspose.Cells.Cell.GetPrecedents trước, và sau đó xây dựng bản đồ phụ thuộc theo bản đồ các ô trước đó.
GetDependentsInCalculation(bool)
Lấy tất cả các ô mà kết quả tính toán phụ thuộc vào ô này.
public IEnumerator GetDependentsInCalculation(bool recursive)
Tham số
recursive
bool
Có trả về những phụ thuộc không tham chiếu đến ô này trực tiếp nhưng tham chiếu đến các lá khác của ô này hay không.
Trả về
Bộ lặp để liệt kê tất cả các phụ thuộc (đối tượng Cell).
Ví dụ
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("Phụ thuộc tính toán của B1:");
while(en.MoveNext())
{
Cell c = (Cell)en.Current;
Console.WriteLine(c.Name);
}
en = cells["B2"].GetDependentsInCalculation(false);
Console.WriteLine("Phụ thuộc tính toán của B2:");
while(en.MoveNext())
{
Cell c = (Cell)en.Current;
Console.WriteLine(c.Name);
}
Nhận xét
Để sử dụng phương thức này, vui lòng đảm bảo rằng workbook đã được thiết lập với giá trị true cho Aspose.Cells.FormulaSettings.EnableCalculationChain và đã được tính toán đầy đủ với thiết lập này. Nếu không có công thức nào tham chiếu đến ô này, null sẽ được trả về.
GetDisplayStyle()
Lấy kiểu hiển thị của ô. Nếu ô này cũng bị ảnh hưởng bởi các cài đặt khác như định dạng điều kiện, đối tượng danh sách, v.v., thì kiểu hiển thị có thể khác với cell.GetStyle().
public Style GetDisplayStyle()
Trả về
GetDisplayStyle(bool)
Lấy kiểu hiển thị của ô. Nếu ô được định dạng điều kiện, kiểu hiển thị không giống như cell.GetStyle().
public Style GetDisplayStyle(bool includeMergedBorders)
Tham số
includeMergedBorders
bool
Chỉ ra liệu có kiểm tra các đường biên của các ô đã hợp nhất hay không.
Trả về
GetFormatConditions()
Lấy các điều kiện định dạng áp dụng cho ô này.
public FormatConditionCollection[] GetFormatConditions()
Trả về
Trả về đối tượng Aspose.Cells.FormatConditionCollection.
GetFormula(bool, bool)
Lấy công thức của ô này.
public string GetFormula(bool isR1C1, bool isLocal)
Tham số
isR1C1
bool
Liệu công thức có cần được định dạng dưới dạng R1C1 hay không.
isLocal
bool
Liệu công thức có cần được định dạng theo ngôn ngữ hay không.
Trả về
công thức của ô này.
GetHashCode()
Đóng vai trò như một hàm băm cho một loại cụ thể.
public override int GetHashCode()
Trả về
Mã băm cho đối tượng Cell hiện tại.
GetHeightOfValue()
Lấy chiều cao của giá trị tính bằng pixel.
public int GetHeightOfValue()
Trả về
GetHtmlString(bool)
Lấy chuỗi html chứa dữ liệu và một số định dạng trong ô này.
public string GetHtmlString(bool html5)
Tham số
html5
bool
Chỉ ra liệu giá trị có tương thích với html5 hay không.
Trả về
GetMergedRange()
Trả về một đối tượng Aspose.Cells.Range đại diện cho một vùng đã hợp nhất.
public Range GetMergedRange()
Trả về
Đối tượng Aspose.Cells.Range. Null nếu ô này không được hợp nhất.
GetPrecedents()
Lấy tất cả các tham chiếu xuất hiện trong công thức của ô này.
public ReferredAreaCollection GetPrecedents()
Trả về
Bộ sưu tập tất cả các tham chiếu xuất hiện trong công thức của ô này.
Ví dụ
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
Nhận xét
- Trả về null nếu đây không phải là ô công thức.
- Tất cả các tham chiếu xuất hiện trong công thức của ô này sẽ được trả về bất kể chúng có được tham chiếu hay không trong quá trình tính toán. Ví dụ, mặc dù ô A2 trong công thức "=IF(TRUE,A1,A2)" không được sử dụng trong quá trình tính toán, nó vẫn được coi là các ô trước đó của công thức.
- Để lấy những tham chiếu ảnh hưởng đến tính toán mà thôi, vui lòng sử dụng Aspose.Cells.Cell.GetPrecedentsInCalculation.
GetPrecedentsInCalculation()
Lấy tất cả các ô trước đó (tham chiếu đến các ô trong workbook hiện tại) được sử dụng bởi công thức của ô này trong quá trình tính toán.
public IEnumerator GetPrecedentsInCalculation()
Trả về
Bộ lặp để liệt kê tất cả các tham chiếu (ReferredArea).
Ví dụ
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("Các ô trước đó của A2:");
while(en.MoveNext())
{
ReferredArea r = (ReferredArea)en.Current;
Console.WriteLine(r);
}
Nhận xét
Phương thức này chỉ hoạt động trong tình huống mà Aspose.Cells.FormulaSettings.EnableCalculationChain là true cho workbook và workbook đã được tính toán đầy đủ. Nếu ô này không phải là công thức hoặc nó không tham chiếu đến bất kỳ ô nào khác, null sẽ được trả về.
GetRichValue()
Lấy giá trị phong phú của ô.
public CellRichValue GetRichValue()
Trả về
GetStringValue(CellValueFormatStrategy)
Lấy giá trị chuỗi theo chiến lược định dạng cụ thể.
public string GetStringValue(CellValueFormatStrategy formatStrategy)
Tham số
formatStrategy
CellValueFormatStrategy
Chiến lược định dạng.
Trả về
GetStyle()
Lấy kiểu của ô.
public Style GetStyle()
Trả về
Đối tượng kiểu.
Nhận xét
Để thay đổi kiểu của ô, vui lòng gọi phương thức Cell.SetStyle() sau khi sửa đổi đối tượng kiểu đã trả về. Phương thức này giống với Aspose.Cells.Cell.GetStyle(System.Boolean) với giá trị true cho tham số.
GetStyle(bool)
Nếu checkBorders là true, kiểm tra xem các đường biên của các ô khác có ảnh hưởng đến kiểu của ô này hay không.
public Style GetStyle(bool checkBorders)
Tham số
checkBorders
bool
Kiểm tra các đường biên của các ô khác.
Trả về
Đối tượng kiểu.
GetTable()
Lấy bảng chứa ô này.
public ListObject GetTable()
Trả về
GetValidation()
Lấy xác thực áp dụng cho ô này.
public Validation GetValidation()
Trả về
GetValidationValue()
Lấy giá trị xác thực áp dụng cho ô này.
public bool GetValidationValue()
Trả về
GetWidthOfValue()
Lấy chiều rộng của giá trị tính bằng pixel.
public int GetWidthOfValue()
Trả về
InsertText(int, string)
Chèn một số ký tự vào ô. Nếu ô được định dạng phong phú, phương thức này có thể giữ nguyên định dạng gốc.
public void InsertText(int index, string text)
Tham số
index
int
Chỉ số.
text
string
Văn bản được chèn.
IsRichText()
Chỉ ra liệu giá trị chuỗi của ô này có phải là văn bản định dạng phong phú hay không.
public bool IsRichText()
Trả về
PutValue(bool)
Đưa một giá trị boolean vào ô.
public void PutValue(bool boolValue)
Tham số
boolValue
bool
PutValue(int)
Đưa một giá trị số nguyên vào ô.
public void PutValue(int intValue)
Tham số
intValue
int
Giá trị đầu vào.
PutValue(double)
Đưa một giá trị double vào ô.
public void PutValue(double doubleValue)
Tham số
doubleValue
double
Giá trị đầu vào.
PutValue(string, bool, bool)
Đưa một giá trị vào ô, nếu thích hợp giá trị sẽ được chuyển đổi sang loại dữ liệu khác và định dạng số của ô sẽ được đặt lại.
public void PutValue(string stringValue, bool isConverted, bool setStyle)
Tham số
stringValue
string
Giá trị đầu vào.
isConverted
bool
True: chuyển đổi sang loại dữ liệu khác nếu thích hợp.
setStyle
bool
True: đặt định dạng số cho kiểu của ô khi chuyển đổi sang loại dữ liệu khác.
PutValue(string, bool)
Đưa một giá trị chuỗi vào ô và chuyển đổi giá trị sang loại dữ liệu khác nếu thích hợp.
public void PutValue(string stringValue, bool isConverted)
Tham số
stringValue
string
Giá trị đầu vào.
isConverted
bool
True: chuyển đổi sang loại dữ liệu khác nếu thích hợp.
PutValue(string)
Đưa một giá trị chuỗi vào ô.
public void PutValue(string stringValue)
Tham số
stringValue
string
Giá trị đầu vào.
PutValue(DateTime)
Đưa một giá trị DateTime vào ô.
public void PutValue(DateTime dateTime)
Tham số
dateTime
DateTime
Giá trị đầu vào.
Ví dụ
Ví dụ này cho thấy cách đặt giá trị DateTime cho một ô và làm cho nó được hiển thị dưới dạng ngày giờ.
Workbook excel = new Workbook();
Cells cells = excel.Worksheets[0].Cells;
//Đưa ngày giờ vào ô
Cell cell = cells[0, 0];
cell.PutValue(new DateTime(2023, 5, 15));
Style style = cell.GetStyle(false);
style.Number = 14;
cell.SetStyle(style);
Nhận xét
Việc đặt một giá trị DateTime cho một ô không có nghĩa là ô sẽ được định dạng tự động dưới dạng ngày giờ. Giá trị DateTime được duy trì dưới dạng giá trị số trong mô hình dữ liệu của cả ms excel và Aspose.Cells. Việc giá trị số sẽ được coi là giá trị số thực tế hay ngày giờ phụ thuộc vào định dạng số áp dụng cho ô này. Nếu ô này chưa được định dạng dưới dạng ngày giờ, nó sẽ được hiển thị dưới dạng giá trị số ngay cả khi những gì bạn nhập là DateTime.
PutValue(object)
Đưa một giá trị đối tượng vào ô.
public void PutValue(object objectValue)
Tham số
objectValue
object
giá trị đầu vào.
RemoveArrayFormula(bool)
Xóa công thức mảng.
public void RemoveArrayFormula(bool leaveNormalFormula)
Tham số
leaveNormalFormula
bool
True đại diện cho việc chuyển đổi công thức mảng thành công thức bình thường.
Replace(string, string, ReplaceOptions)
Thay thế văn bản của ô với các tùy chọn.
public void Replace(string placeHolder, string newValue, ReplaceOptions options)
Tham số
placeHolder
string
Chuỗi thay thế của ô.
newValue
string
Giá trị chuỗi để thay thế.
options
ReplaceOptions
Tùy chọn thay thế.
SetArrayFormula(string, int, int)
Thiết lập một công thức mảng (công thức mảng cổ điển được nhập qua CTRL+SHIFT+ENTER trong ms excel) cho một phạm vi ô.
public void SetArrayFormula(string arrayFormula, int rowNumber, int columnNumber)
Tham số
arrayFormula
string
Công thức mảng.
rowNumber
int
Số hàng để điền kết quả của công thức mảng.
columnNumber
int
Số cột để điền kết quả của công thức mảng.
SetArrayFormula(string, int, int, FormulaParseOptions)
Thiết lập một công thức mảng cho một phạm vi ô.
public void SetArrayFormula(string arrayFormula, int rowNumber, int columnNumber, FormulaParseOptions options)
Tham số
arrayFormula
string
Công thức mảng.
rowNumber
int
Số hàng để điền kết quả của công thức mảng.
columnNumber
int
Số cột để điền kết quả của công thức mảng.
options
FormulaParseOptions
Tùy chọn cho việc phân tích công thức.
SetArrayFormula(string, int, int, FormulaParseOptions, object[][])
Thiết lập một công thức mảng cho một phạm vi ô.
public void SetArrayFormula(string arrayFormula, int rowNumber, int columnNumber, FormulaParseOptions options, object[][] values)
Tham số
arrayFormula
string
Công thức mảng.
rowNumber
int
Số hàng để điền kết quả của công thức mảng.
columnNumber
int
Số cột để điền kết quả của công thức mảng.
options
FormulaParseOptions
Tùy chọn cho việc phân tích công thức.
values
object[][]
giá trị cho các ô với công thức mảng đã cho.
SetCharacters(FontSetting[])
Thiết lập định dạng văn bản phong phú của ô.
public void SetCharacters(FontSetting[] characters)
Tham số
characters
FontSetting[]
Tất cả các đối tượng Characters.
SetDynamicArrayFormula(string, FormulaParseOptions, bool)
Thiết lập công thức mảng động và làm cho công thức tràn vào các ô lân cận nếu có thể.
public CellArea SetDynamicArrayFormula(string arrayFormula, FormulaParseOptions options, bool calculateValue)
Tham số
arrayFormula
string
biểu thức công thức.
options
FormulaParseOptions
tùy chọn để phân tích công thức. Tùy chọn “Parse” sẽ bị bỏ qua và công thức sẽ luôn được phân tích ngay lập tức.
calculateValue
bool
có tính toán công thức mảng động này cho những ô trong phạm vi tràn hay không.
Trả về
phạm vi mà công thức nên tràn vào.
Nhận xét
phạm vi trả về có thể không giống với phạm vi thực tế mà công thức mảng động này tràn vào. Nếu có ô không trống trong phạm vi, công thức sẽ chỉ được đặt cho ô hiện tại và được đánh dấu là “#SPILL!”. Nhưng trong tình huống như vậy, chúng tôi vẫn trả về toàn bộ phạm vi mà công thức này nên tràn vào.
SetDynamicArrayFormula(string, FormulaParseOptions, object[][], bool, bool)
Thiết lập công thức mảng động và làm cho công thức tràn vào các ô lân cận nếu có thể.
public CellArea SetDynamicArrayFormula(string arrayFormula, FormulaParseOptions options, object[][] values, bool calculateRange, bool calculateValue)
Tham số
arrayFormula
string
biểu thức công thức.
options
FormulaParseOptions
tùy chọn để phân tích công thức. Tùy chọn “Parse” sẽ bị bỏ qua và công thức sẽ luôn được phân tích ngay lập tức.
values
object[][]
giá trị (kết quả tính toán) cho những ô với công thức mảng động đã cho.
calculateRange
bool
Có tính toán phạm vi tràn cho công thức mảng động này hay không. Nếu tham số “values” không null và cờ này là false, thì chiều cao của phạm vi tràn sẽ là values.Length và chiều rộng sẽ là values[0].Length.
calculateValue
bool
có tính toán công thức mảng động này cho những ô trong phạm vi tràn khi “values” là null hoặc mục tương ứng trong “values” cho một ô là null.
Trả về
phạm vi mà công thức nên tràn vào.
Nhận xét
phạm vi trả về có thể không giống với phạm vi thực tế mà công thức mảng động này tràn vào. Nếu có ô không trống trong phạm vi, công thức sẽ chỉ được đặt cho ô hiện tại và được đánh dấu là “#SPILL!”. Nhưng trong tình huống như vậy, chúng tôi vẫn trả về toàn bộ phạm vi mà công thức này nên tràn vào.
SetDynamicArrayFormula(string, FormulaParseOptions, object[][], bool, bool, CalculationOptions)
Thiết lập công thức mảng động và làm cho công thức tràn vào các ô lân cận nếu có thể.
public CellArea SetDynamicArrayFormula(string arrayFormula, FormulaParseOptions options, object[][] values, bool calculateRange, bool calculateValue, CalculationOptions copts)
Tham số
arrayFormula
string
biểu thức công thức.
options
FormulaParseOptions
tùy chọn để phân tích công thức. Tùy chọn “Parse” sẽ bị bỏ qua và công thức sẽ luôn được phân tích ngay lập tức.
values
object[][]
giá trị (kết quả tính toán) cho những ô với công thức mảng động đã cho.
calculateRange
bool
Có tính toán phạm vi tràn cho công thức mảng động này hay không. Nếu tham số “values” không null và cờ này là false, thì chiều cao của phạm vi tràn sẽ là values.Length và chiều rộng sẽ là values[0].Length.
calculateValue
bool
có tính toán công thức mảng động này cho những ô trong phạm vi tràn khi “values” là null hoặc mục tương ứng trong “values” cho một ô là null.
copts
CalculationOptions
Tùy chọn cho việc tính toán công thức. Thông thường, vì lý do hiệu suất, thuộc tính Aspose.Cells.CalculationOptions.Recursive nên là false.
Trả về
phạm vi mà công thức nên tràn vào.
Nhận xét
phạm vi trả về có thể không giống với phạm vi thực tế mà công thức mảng động này tràn vào. Nếu có ô không trống trong phạm vi, công thức sẽ chỉ được đặt cho ô hiện tại và được đánh dấu là “#SPILL!”. Nhưng trong tình huống như vậy, chúng tôi vẫn trả về toàn bộ phạm vi mà công thức này nên tràn vào.
SetFormula(string, object)
Thiết lập công thức và giá trị (kết quả tính toán) của công thức.
public void SetFormula(string formula, object value)
Tham số
formula
string
Công thức.
value
object
Giá trị (kết quả tính toán) của công thức.
SetFormula(string, FormulaParseOptions)
Thiết lập công thức và giá trị (kết quả tính toán) của công thức.
public void SetFormula(string formula, FormulaParseOptions options)
Tham số
formula
string
Công thức.
options
FormulaParseOptions
Tùy chọn cho việc phân tích công thức.
SetFormula(string, FormulaParseOptions, object)
Thiết lập công thức và giá trị (kết quả tính toán) của công thức.
public void SetFormula(string formula, FormulaParseOptions options, object value)
Tham số
formula
string
Công thức.
options
FormulaParseOptions
Tùy chọn cho việc phân tích công thức.
value
object
Giá trị (kết quả tính toán) của công thức.
SetSharedFormula(string, int, int)
Thiết lập công thức chia sẻ cho một phạm vi ô.
public void SetSharedFormula(string sharedFormula, int rowNumber, int columnNumber)
Tham số
sharedFormula
string
Công thức chia sẻ.
rowNumber
int
Số hàng để điền công thức.
columnNumber
int
Số cột để điền công thức.
SetSharedFormula(string, int, int, FormulaParseOptions)
Thiết lập công thức chia sẻ cho một phạm vi ô.
public void SetSharedFormula(string sharedFormula, int rowNumber, int columnNumber, FormulaParseOptions options)
Tham số
sharedFormula
string
Công thức chia sẻ.
rowNumber
int
Số hàng để điền công thức.
columnNumber
int
Số cột để điền công thức.
options
FormulaParseOptions
Tùy chọn cho việc phân tích công thức.
SetSharedFormula(string, int, int, FormulaParseOptions, object[][])
Thiết lập công thức chia sẻ cho một phạm vi ô.
public void SetSharedFormula(string sharedFormula, int rowNumber, int columnNumber, FormulaParseOptions options, object[][] values)
Tham số
sharedFormula
string
Công thức chia sẻ.
rowNumber
int
Số hàng để điền công thức.
columnNumber
int
Số cột để điền công thức.
options
FormulaParseOptions
Tùy chọn cho việc phân tích công thức.
values
object[][]
giá trị cho các ô với công thức chia sẻ đã cho.
SetStyle(Style)
Thiết lập kiểu cho ô.
public void SetStyle(Style style)
Tham số
style
Style
Kiểu của ô.
Nhận xét
Nếu các cài đặt đường biên bị thay đổi, đường biên của các ô điều chỉnh cũng sẽ được cập nhật.
SetStyle(Style, bool)
Áp dụng thuộc tính đã thay đổi của kiểu cho ô.
public void SetStyle(Style style, bool explicitFlag)
Tham số
style
Style
Kiểu của ô.
explicitFlag
bool
True, chỉ ghi đè định dạng được đặt rõ ràng.
SetStyle(Style, StyleFlag)
Áp dụng kiểu ô dựa trên cờ.
public void SetStyle(Style style, StyleFlag flag)
Tham số
style
Style
Kiểu của ô.
flag
StyleFlag
Cờ kiểu.
SetTableFormula(int, int, string, string, object[][])
Tạo bảng dữ liệu hai biến cho phạm vi đã cho bắt đầu từ ô này.
public void SetTableFormula(int rowNumber, int columnNumber, string rowInputCell, string columnInputCell, object[][] values)
Tham số
rowNumber
int
Số hàng để điền công thức.
columnNumber
int
Số cột để điền công thức.
rowInputCell
string
ô đầu vào hàng.
columnInputCell
string
ô đầu vào cột.
values
object[][]
giá trị cho các ô trong phạm vi công thức bảng.
SetTableFormula(int, int, string, bool, object[][])
Tạo bảng dữ liệu một biến cho phạm vi đã cho bắt đầu từ ô này.
public void SetTableFormula(int rowNumber, int columnNumber, string inputCell, bool isRowInput, object[][] values)
Tham số
rowNumber
int
Số hàng để điền công thức.
columnNumber
int
Số cột để điền công thức.
inputCell
string
ô đầu vào.
isRowInput
bool
Chỉ ra liệu ô đầu vào là ô đầu vào hàng (true) hay ô đầu vào cột (false).
values
object[][]
giá trị cho các ô trong phạm vi công thức bảng.
SetTableFormula(int, int, int, int, int, int, object[][])
Tạo bảng dữ liệu hai biến cho phạm vi đã cho bắt đầu từ ô này.
public void SetTableFormula(int rowNumber, int columnNumber, int rowIndexOfRowInputCell, int columnIndexOfRowInputCell, int rowIndexOfColumnInputCell, int columnIndexOfColumnInputCell, object[][] values)
Tham số
rowNumber
int
Số hàng để điền công thức.
columnNumber
int
Số cột để điền công thức.
rowIndexOfRowInputCell
int
chỉ số hàng của ô đầu vào hàng.
columnIndexOfRowInputCell
int
chỉ số cột của ô đầu vào hàng.
rowIndexOfColumnInputCell
int
chỉ số hàng của ô đầu vào cột.
columnIndexOfColumnInputCell
int
chỉ số cột của ô đầu vào cột.
values
object[][]
giá trị cho các ô trong phạm vi công thức bảng.
SetTableFormula(int, int, int, int, bool, object[][])
Tạo bảng dữ liệu một biến cho phạm vi đã cho bắt đầu từ ô này.
public void SetTableFormula(int rowNumber, int columnNumber, int rowIndexOfInputCell, int columnIndexOfInputCell, bool isRowInput, object[][] values)
Tham số
rowNumber
int
Số hàng để điền công thức.
columnNumber
int
Số cột để điền công thức.
rowIndexOfInputCell
int
chỉ số hàng của ô đầu vào.
columnIndexOfInputCell
int
chỉ số cột của ô đầu vào.
isRowInput
bool
Chỉ ra liệu ô đầu vào là ô đầu vào hàng (true) hay ô đầu vào cột (false).
values
object[][]
giá trị cho các ô trong phạm vi công thức bảng.
ToJson()
Chuyển đổi Aspose.Cells.Cell thành dữ liệu cấu trúc JSON.
public string ToJson()
Trả về
ToString()
Trả về một chuỗi đại diện cho đối tượng Cell hiện tại.
public override string ToString()