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; }يشير إلى ما إذا كانت القيمة الداخلية لهذه الخلية رقمية (عدد صحيح ومزدوج وتاريخ ووقت)
IsSharedFormula { get; }يشير إلى ما إذا كانت صيغة الخلية جزء من صيغة مشتركة.
IsStyleSet { get; }يشير إلى ما إذا تم تعيين نمط الخلية. إذا تم إرجاع خطأ ، فهذا يعني أن هذه الخلية لها تنسيق افتراضي للخلية.
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()الحصول على نمط عرض الخلية. إذا تأثرت هذه الخلية أيضًا بإعدادات أخرى مثل التنسيق الشرطي وكائنات القائمة وما إلى ذلك ، فقد يختلف نمط العرض عن الخلية. 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)يعين صيغة صفيف (صيغة صفيف قديمة تم إدخالها عبر 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()إرجاع سلسلة تمثل كائن الخلية الحالي.

أمثلة

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

// ضع صيغة مجمعة: "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

// ضع مزدوج في خلية
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)

أنظر أيضا

CalculationPrecisionStrategy CellArea