Class Cell

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

objectCell

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

bool

Column

Lấy số cột (bắt đầu từ 0) của ô.

public int Column { get; }

Giá trị thuộc tính

int

Comment

Lấy chú thích của ô này.

public Comment Comment { get; }

Giá trị thuộc tính

Comment

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

bool

DateTimeValue

Lấy giá trị DateTime chứa trong ô.

public DateTime DateTimeValue { get; }

Giá trị thuộc tính

DateTime

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

string

DoubleValue

Lấy giá trị double chứa trong ô.

public double DoubleValue { get; }

Giá trị thuộc tính

double

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

float

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

string

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

string

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

bool

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

string

IntValue

Lấy giá trị số nguyên chứa trong ô.

public int IntValue { get; }

Giá trị thuộc tính

int

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

bool

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

bool

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

bool

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

bool

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

bool

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

bool

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

bool

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

bool

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

bool

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

bool

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

bool

Name

Lấy tên của ô.

public string Name { get; }

Giá trị thuộc tính

string

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

NumberCategoryType

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

string

Row

Lấy số hàng (bắt đầu từ 0) của ô.

public int Row { get; }

Giá trị thuộc tính

int

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

int

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

string

Type

Đại diện cho loại giá trị của ô.

public CellValueType Type { get; }

Giá trị thuộc tính

CellValueType

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

object

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

Worksheet

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ề

FontSetting

Đố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ề

bool

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ề

bool

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ề

CellArea

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ề

FontSetting[]

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ề

FontSetting[]

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ề

ConditionalFormattingResult

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ề

IEnumerator

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ề

Style

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ề

Style

GetFormatConditions()

Lấy các điều kiện định dạng áp dụng cho ô này.

public FormatConditionCollection[] GetFormatConditions()

Trả về

FormatConditionCollection[]

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ề

string

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ề

int

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ề

int

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ề

string

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ề

Range

Đố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ề

ReferredAreaCollection

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ề

IEnumerator

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ề

CellRichValue

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ề

string

GetStyle()

Lấy kiểu của ô.

public Style GetStyle()

Trả về

Style

Đố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ề

Style

Đối tượng kiểu.

GetTable()

Lấy bảng chứa ô này.

public ListObject GetTable()

Trả về

ListObject

GetValidation()

Lấy xác thực áp dụng cho ô này.

public Validation GetValidation()

Trả về

Validation

GetValidationValue()

Lấy giá trị xác thực áp dụng cho ô này.

public bool GetValidationValue()

Trả về

bool

GetWidthOfValue()

Lấy chiều rộng của giá trị tính bằng pixel.

public int GetWidthOfValue()

Trả về

int

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ề

bool

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ề

CellArea

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ề

CellArea

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ề

CellArea

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ề

string

ToString()

Trả về một chuỗi đại diện cho đối tượng Cell hiện tại.

public override string ToString()

Trả về

string

 Tiếng Việt