Class Cell

Column

يحصل على رقم العمود (بدءًا من الصفر) للخلية.

public int Column { get; }

قيمة الخاصية

Comment

يحصل على تعليق هذه الخلية.

public Comment Comment { get; }

قيمة الخاصية

Comment

ملاحظات

إذا لم يكن هناك تعليق ينطبق على الخلية، فإنها تعيد null.

ContainsExternalLink

تشير إلى ما إذا كانت هذه الخلية تحتوي على رابط خارجي. تنطبق فقط عندما تكون الخلية عبارة عن خلية صيغة.

public bool ContainsExternalLink { get; }

قيمة الخاصية

DateTimeValue

يحصل على قيمة DateTime الموجودة في الخلية.

public DateTime DateTimeValue { get; }

قيمة الخاصية

DateTime

DisplayStringValue

يحصل على القيمة النصية المنسقة لهذه الخلية حسب نمط عرض الخلية.

public string DisplayStringValue { get; }

قيمة الخاصية

DoubleValue

يحصل على القيمة المزدوجة الموجودة في الخلية.

public double DoubleValue { get; }

قيمة الخاصية

double

EmbeddedImage

يحصل على الصورة المدمجة في الخلية ويقوم بتعيينها.

public byte[] EmbeddedImage { get; set; }

قيمة الخاصية

byte[]

FloatValue

يحصل على القيمة العائمة الموجودة في الخلية.

public float FloatValue { get; }

قيمة الخاصية

float

Formula

يحصل على صيغة أو يقوم بتعيينها لـ Aspose.Cells.Cell.

public string Formula { get; set; }

قيمة الخاصية

أمثلة

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"

ملاحظات

تبدأ سلسلة الصيغة دائمًا بعلامة يساوي (=). ويرجى دائمًا استخدام الفاصلة (,) كفاصل بين المعلمات، مثل “=SUM(A1, E1, H2)”.

FormulaLocal

احصل على صيغة الخلية بتنسيق محلي.

public string FormulaLocal { get; set; }

قيمة الخاصية

HasCustomStyle

تشير إلى ما إذا كانت هذه الخلية تحتوي على إعدادات نمط مخصصة (مختلفة عن النمط الافتراضي الموروث من الصف أو العمود أو دفتر العمل المقابل).

public bool HasCustomStyle { get; }

قيمة الخاصية

HtmlString

يحصل على سلسلة HTML ويقوم بتعيينها والتي تحتوي على بيانات وبعض التنسيقات في هذه الخلية.

public string HtmlString { get; set; }

قيمة الخاصية

IntValue

يحصل على القيمة الصحيحة الموجودة في الخلية.

public int IntValue { get; }

قيمة الخاصية

IsArrayFormula

تشير إلى ما إذا كانت صيغة الخلية عبارة عن صيغة مصفوفة.

public bool IsArrayFormula { get; }

قيمة الخاصية

IsArrayHeader

تشير إلى أن صيغة الخلية عبارة عن صيغة مصفوفة وأنها الخلية الأولى من المصفوفة.

public bool IsArrayHeader { get; }

قيمة الخاصية

IsCheckBoxStyle

تشير إلى ما إذا كانت هذه الخلية تم تعيينها كخانة اختيار.

public bool IsCheckBoxStyle { get; set; }

قيمة الخاصية

IsDynamicArrayFormula

تشير إلى ما إذا كانت صيغة الخلية هي صيغة مصفوفة ديناميكية (صحيحة) أو صيغة مصفوفة قديمة (خطأ).

public bool IsDynamicArrayFormula { get; }

قيمة الخاصية

IsErrorValue

يتحقق مما إذا كانت قيمة هذه الخلية هي خطأ.

public bool IsErrorValue { get; }

قيمة الخاصية

NumberCategoryType

يمثل نوع الفئة لتنسيق الرقم لهذه الخلية.

public NumberCategoryType NumberCategoryType { get; }

قيمة الخاصية

NumberCategoryType

ملاحظات

عندما يتم دمج نمط تنسيق الخلية مع أنماط تنسيق شرطية، فإن النوع المعاد يتوافق مع الجزء المستخدم للقيمة الحالية لهذه الخلية. على سبيل المثال، إذا كان نمط التنسيق لهذه الخلية هو “#,##0;(#,##0);”-";@", فعندما تكون قيمة الخلية عددية وليست 0، يكون النوع المعاد هو Aspose.Cells.NumberCategoryType.Number؛ عندما تكون قيمة الخلية 0 أو ليست قيمة عددية، يكون النوع المعاد هو Aspose.Cells.NumberCategoryType.Text.

R1C1Formula

يحصل على صيغة R1C1 لـ Aspose.Cells.Cell أو يقوم بتعيينها.

public string R1C1Formula { get; set; }

قيمة الخاصية

Row

يحصل على رقم الصف (بدءًا من الصفر) للخلية.

public int Row { get; }

قيمة الخاصية

SharedStyleIndex

يحصل على فهرس نمط الخلية المشترك في مجموعة الأنماط.

public int SharedStyleIndex { get; }

قيمة الخاصية

StringValue

يحصل على القيمة النصية الموجودة في الخلية. إذا كان نوع هذه الخلية هو نص، فستعيد القيمة النصية نفسها. بالنسبة لأنواع الخلايا الأخرى، سيتم إرجاع القيمة النصية المنسقة (المنسقة مع النمط المحدد لهذه الخلية). تكون القيمة المنسقة للخلية كما يمكنك الحصول عليها من Excel عند نسخ خلية كنص (مثل نسخ الخلية إلى محرر نصوص أو تصديرها إلى CSV).

public string StringValue { get; }

قيمة الخاصية

Type

تمثل نوع قيمة الخلية.

public CellValueType Type { get; }

قيمة الخاصية

CellValueType

Value

يحصل على/يعيين القيمة الموجودة في هذه الخلية.

public object Value { get; set; }

قيمة الخاصية

object

ملاحظات

النوع المحتمل:

null,

Boolean,

DateTime,

Double,

Integer

String.

بالنسبة للقيمة الصحيحة، قد يتم إرجاعها ككائن عدد صحيح أو كائن مزدوج. وليس هناك ضمان بأن القيمة المعادة ستبقى من نفس نوع الكائن دائمًا.

Worksheet

يحصل على ورقة العمل الأصلية.

public Worksheet Worksheet { get; }

قيمة الخاصية

Worksheet

الطرق

Calculate(CalculationOptions)

يحسب صيغة الخلية.

public void Calculate(CalculationOptions options)

المعلمات

options CalculationOptions

خيارات الحساب

Characters(int, int)

يعيد كائن Characters الذي يمثل نطاقًا من الأحرف داخل نص الخلية.

public FontSetting Characters(int startIndex, int length)

المعلمات

startIndex int

فهرس بداية الحرف.

length int

عدد الأحرف.

الإرجاع

FontSetting

كائن Characters.

أمثلة

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

ملاحظات

تعمل هذه الطريقة فقط على الخلية ذات القيمة النصية.

Copy(Cell)

ينسخ البيانات من خلية المصدر.

public void Copy(Cell cell)

المعلمات

cell Cell

كائن Aspose.Cells.Cell المصدر.

Equals(object)

يتحقق مما إذا كان هذا الكائن يشير إلى نفس الخلية مع كائن آخر.

public override bool Equals(object obj)

المعلمات

obj object

كائن آخر

الإرجاع

صحيح إذا كان الكائنان يشيران إلى نفس الخلية.

Equals(Cell)

يتحقق مما إذا كان هذا الكائن يشير إلى نفس الخلية مع كائن خلية آخر.

public bool Equals(Cell cell)

المعلمات

cell Cell

كائن خلية آخر

الإرجاع

صحيح إذا كان الكائنان يشيران إلى نفس الخلية.

GetArrayRange()

يحصل على نطاق المصفوفة إذا كانت صيغة الخلية هي صيغة مصفوفة.

public CellArea GetArrayRange()

الإرجاع

ConditionalFormattingResult

نطاق المصفوفة.

ملاحظات

تنطبق فقط عندما تكون صيغة الخلية هي صيغة مصفوفة

GetCharacters()

يعيد جميع كائنات Characters التي تمثل نطاقًا من الأحرف داخل نص الخلية.

public FontSetting[] GetCharacters()

الإرجاع

FontSetting[]

جميع كائنات Characters

GetCharacters(bool)

يعيد جميع كائنات Characters التي تمثل نطاقًا من الأحرف داخل نص الخلية.

public FontSetting[] GetCharacters(bool flag)

المعلمات

flag bool

تشير إلى ما إذا كانت ستطبق نمط الجدول على الخلية إذا كانت الخلية في الجدول.

الإرجاع

FontSetting[]

جميع كائنات Characters

GetConditionalFormattingResult()

احصل على نتيجة التنسيق الشرطي.

public ConditionalFormattingResult GetConditionalFormattingResult()

الإرجاع

ملاحظات

تُرجع null إذا لم يكن هناك تنسيق شرطي مُطبق على هذه الخلية،

GetDependents(bool)

احصل على جميع الخلايا التي تشير صيغةها مباشرةً إلى هذه الخلية.

public Cell[] GetDependents(bool isAll)

المعلمات

isAll bool

تشير إلى ما إذا كان يجب التحقق من الصيغ في أوراق العمل الأخرى

الإرجاع

Cell[]

أمثلة

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);
}

ملاحظات

إذا كان أحد المراجع التي تحتوي على هذه الخلية يظهر في صيغة إحدى الخلايا، فستعتبر تلك الخلية تابعة لهذه الخلية، بغض النظر عما إذا كان المرجع أو هذه الخلية مستخدمة أثناء الحساب. على سبيل المثال، على الرغم من أن الخلية A2 في الصيغة "=IF(TRUE,A1,A2)" لا تُستخدم أثناء الحساب، إلا أن هذه الصيغة لا تزال تُعتبر تابعة لـ A2.
للحصول على تلك الصيغ التي تعتمد نتائجها المحسوبة على هذه الخلية، يرجى استخدام Aspose.Cells.Cell.GetDependentsInCalculation(System.Boolean).
عند تتبع التوابع لخلية واحدة، سيتم تحليل جميع الصيغ في دفتر العمل أو ورقة العمل والتحقق منها. لذا فإن هذه عملية تستغرق وقتًا. إذا كان المستخدم بحاجة إلى تتبع التوابع للعديد من الخلايا، فإن استخدام هذه الطريقة سيؤدي إلى أداء ضعيف. لأغراض الأداء، ينبغي على المستخدم استخدام Aspose.Cells.Cell.GetDependentsInCalculation(System.Boolean) بدلاً من ذلك. أو، يمكن للمستخدم جمع خريطة السابقين لجميع الخلايا باستخدام Aspose.Cells.Cell.GetPrecedents أولاً، ثم بناء خريطة التوابع وفقًا لخريطة السابقين.

GetDependentsInCalculation(bool)

يحصل على جميع الخلايا التي تعتمد النتيجة المحسوبة عليها.

public IEnumerator GetDependentsInCalculation(bool recursive)

المعلمات

recursive bool

سواء كانت تعيد تلك التوابع التي لا تشير مباشرةً إلى هذه الخلية ولكن تشير إلى أوراق أخرى من هذه الخلية

الإرجاع

IEnumerator

عداد لتعداد جميع التوابع (كائنات Cell)

أمثلة

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("التوابع المحسوبة لـ B1:");
while(en.MoveNext())
{
    Cell c = (Cell)en.Current;
    Console.WriteLine(c.Name);
}
en = cells["B2"].GetDependentsInCalculation(false);
Console.WriteLine("التوابع المحسوبة لـ B2:");
while(en.MoveNext())
{
    Cell c = (Cell)en.Current;
    Console.WriteLine(c.Name);
}

ملاحظات

لاستخدام هذه الطريقة، يرجى التأكد من أن دفتر العمل قد تم تعيينه بقيمة صحيحة لـ Aspose.Cells.FormulaSettings.EnableCalculationChain وقد تم حسابه بالكامل مع هذا الإعداد. إذا لم يكن هناك صيغة تشير إلى هذه الخلية، فسيتم إرجاع null.

GetDisplayStyle()

يحصل على نمط عرض الخلية. إذا تأثرت هذه الخلية أيضًا بإعدادات أخرى مثل التنسيق الشرطي، كائنات القائمة، إلخ، فقد يكون نمط العرض مختلفًا عن cell.GetStyle().

public Style GetDisplayStyle()

الإرجاع

GetDisplayStyle(bool)

يحصل على نمط عرض الخلية. إذا كانت الخلية مُنسقة بشكل شرطي، فإن نمط العرض ليس هو نفسه cell.GetStyle().

public Style GetDisplayStyle(bool includeMergedBorders)

المعلمات

includeMergedBorders bool

تشير إلى ما إذا كانت تتحقق من حدود الخلايا المدمجة.

الإرجاع

FormatConditionCollection[]

GetFormatConditions()

يحصل على شروط التنسيق التي تنطبق على هذه الخلية.

public FormatConditionCollection[] GetFormatConditions()

الإرجاع

يعيد كائن Aspose.Cells.FormatConditionCollection

GetFormula(bool, bool)

احصل على صيغة هذه الخلية.

public string GetFormula(bool isR1C1, bool isLocal)

المعلمات

isR1C1 bool

سواء كانت الصيغة تحتاج إلى تنسيق كـ R1C1.

isLocal bool

سواء كانت الصيغة تحتاج إلى تنسيق حسب اللغة المحلية.

الإرجاع

صيغة هذه الخلية.

GetHashCode()

يعمل كوظيفة تجزئة لنوع معين.

public override int GetHashCode()

الإرجاع

رمز تجزئة لكائن Cell الحالي.

GetHeightOfValue()

يحصل على ارتفاع القيمة بوحدة البكسل.

public int GetHeightOfValue()

الإرجاع

GetHtmlString(bool)

يحصل على سلسلة HTML التي تحتوي على بيانات وبعض التنسيقات في هذه الخلية.

public string GetHtmlString(bool html5)

المعلمات

html5 bool

تشير إلى ما إذا كانت القيمة متوافقة مع HTML5

الإرجاع

GetMergedRange()

يعيد كائن Aspose.Cells.Range الذي يمثل نطاقًا مدمجًا.

public Range GetMergedRange()

الإرجاع

Range

كائن Aspose.Cells.Range. Null إذا لم تكن هذه الخلية مدمجة.

GetPrecedents()

يحصل على جميع المراجع التي تظهر في صيغة هذه الخلية.

public ReferredAreaCollection GetPrecedents()

الإرجاع

ReferredAreaCollection

مجموعة من جميع المراجع التي تظهر في صيغة هذه الخلية.

أمثلة

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

ملاحظات

تُرجع null إذا لم تكن هذه خلية صيغة.
سيتم إرجاع جميع المراجع التي تظهر في صيغة هذه الخلية بغض النظر عما إذا كانت مستخدمة أو لا أثناء الحساب. على سبيل المثال، على الرغم من أن الخلية A2 في الصيغة "=IF(TRUE,A1,A2)" لا تُستخدم أثناء الحساب، إلا أنها لا تزال تُعتبر سابقة للصيغة.
للحصول على تلك المراجع التي تؤثر فقط على الحساب، يرجى استخدام Aspose.Cells.Cell.GetPrecedentsInCalculation.

GetPrecedentsInCalculation()

يحصل على جميع السابقين (الإشارة إلى الخلايا في دفتر العمل الحالي) المستخدمين بواسطة صيغة هذه الخلية أثناء حسابها.

public IEnumerator GetPrecedentsInCalculation()

الإرجاع

IEnumerator

عداد لتعداد جميع المراجع (ReferredArea)

أمثلة

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("السابقون المحسوبون لـ A2:");
while(en.MoveNext())
{
    ReferredArea r = (ReferredArea)en.Current;
    Console.WriteLine(r);
}

ملاحظات

تعمل هذه الطريقة فقط في الحالة التي تكون فيها Aspose.Cells.FormulaSettings.EnableCalculationChain صحيحة لدفتر العمل وقد تم حساب دفتر العمل بالكامل. إذا لم تكن هذه الخلية صيغة أو لم تشير إلى أي خلايا أخرى، فسيتم إرجاع null.

GetRichValue()

يحصل على القيمة الغنية للخلية.

public CellRichValue GetRichValue()

الإرجاع

CellRichValue

GetStringValue(CellValueFormatStrategy)

يحصل على القيمة النصية باستراتيجية تنسيق محددة.

public string GetStringValue(CellValueFormatStrategy formatStrategy)

المعلمات

formatStrategy CellValueFormatStrategy

استراتيجية التنسيق.

الإرجاع

GetStyle()

يحصل على نمط الخلية.

public Style GetStyle()

الإرجاع

كائن النمط.

ملاحظات

لتغيير نمط الخلية، يرجى استدعاء طريقة Cell.SetStyle() بعد تعديل كائن النمط المعاد. تعمل هذه الطريقة بنفس طريقة Aspose.Cells.Cell.GetStyle(System.Boolean) مع قيمة صحيحة للمعلمة.

GetStyle(bool)

إذا كانت checkBorders صحيحة، تحقق مما إذا كانت حدود خلايا أخرى ستؤثر على نمط هذه الخلية.

public Style GetStyle(bool checkBorders)

المعلمات

checkBorders bool

تحقق من حدود خلايا أخرى

الإرجاع

كائن النمط.

GetTable()

يحصل على الجدول الذي يحتوي على هذه الخلية.

public ListObject GetTable()

الإرجاع

ListObject

GetValidation()

يحصل على التحقق من الصحة المطبق على هذه الخلية.

public Validation GetValidation()

الإرجاع

Validation

GetValidationValue()

يحصل على قيمة التحقق من الصحة المطبق على هذه الخلية.

public bool GetValidationValue()

الإرجاع

GetWidthOfValue()

يحصل على عرض القيمة بوحدة البكسل.

public int GetWidthOfValue()

الإرجاع

InsertText(int, string)

يُدخل بعض الأحرف في الخلية. إذا كانت الخلية منسقة بشكل غني، يمكن أن تحتفظ هذه الطريقة بالتنسيق الأصلي.

public void InsertText(int index, string text)

المعلمات

index int

الفهرس.

text string

النص المدخل.

IsRichText()

تشير إلى ما إذا كانت القيمة النصية لهذه الخلية نصًا منسقًا بشكل غني.

public bool IsRichText()

الإرجاع

PutValue(bool)

يُدخل قيمة منطقية في الخلية.

public void PutValue(bool boolValue)

المعلمات

boolValue bool

PutValue(int)

يُدخل قيمة صحيحة في الخلية.

public void PutValue(int intValue)

المعلمات

intValue int

القيمة المدخلة

PutValue(double)

يُدخل قيمة مزدوجة في الخلية.

public void PutValue(double doubleValue)

المعلمات

doubleValue double

القيمة المدخلة

PutValue(string, bool, bool)

يُدخل قيمة في الخلية، إذا كان ذلك مناسبًا، ستتحول القيمة إلى نوع بيانات آخر وسيتم إعادة تعيين تنسيق الرقم للخلية.

public void PutValue(string stringValue, bool isConverted, bool setStyle)

المعلمات

stringValue string

القيمة المدخلة

isConverted bool

صحيح: تم تحويله إلى نوع بيانات آخر إذا كان ذلك مناسبًا.

setStyle bool

صحيح: تعيين تنسيق الرقم إلى نمط الخلية عند التحويل إلى نوع بيانات آخر

PutValue(string, bool)

يُدخل قيمة نصية في الخلية ويحول القيمة إلى نوع بيانات آخر إذا كان ذلك مناسبًا.

public void PutValue(string stringValue, bool isConverted)

المعلمات

stringValue string

القيمة المدخلة

isConverted bool

صحيح: تم تحويله إلى نوع بيانات آخر إذا كان ذلك مناسبًا.

PutValue(string)

يُدخل قيمة نصية في الخلية.

public void PutValue(string stringValue)

المعلمات

stringValue string

القيمة المدخلة

PutValue(DateTime)

يُدخل قيمة DateTime في الخلية.

public void PutValue(DateTime dateTime)

المعلمات

dateTime DateTime

القيمة المدخلة

أمثلة

توضح هذه الأمثلة كيفية تعيين قيمة DateTime لخلية وجعلها تُعرض كتاريخ ووقت.

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

//إدخال تاريخ ووقت في خلية
Cell cell = cells[0, 0];
cell.PutValue(new DateTime(2023, 5, 15));
Style style = cell.GetStyle(false);
style.Number = 14;
cell.SetStyle(style);

ملاحظات

تعيين قيمة DateTime لخلية لا يعني أن الخلية ستتم تنسيقها كتاريخ ووقت تلقائيًا. يتم الاحتفاظ بقيمة DateTime كقيمة عددية في نموذج البيانات لكل من Excel وAspose.Cells. ما إذا كانت القيمة العددية ستؤخذ كقيمة عددية نفسها أو كتاريخ ووقت يعتمد على تنسيق الرقم المطبق على هذه الخلية. إذا لم يتم تنسيق هذه الخلية كتاريخ ووقت، فسيتم عرضها كقيمة عددية حتى لو كان ما أدخلته هو DateTime.

PutValue(object)

يُدخل قيمة كائن في الخلية.

public void PutValue(object objectValue)

المعلمات

objectValue object

القيمة المدخلة

RemoveArrayFormula(bool)

إزالة صيغة المصفوفة.

public void RemoveArrayFormula(bool leaveNormalFormula)

المعلمات

leaveNormalFormula bool

صحيح يمثل تحويل صيغة المصفوفة إلى صيغة عادية.

Replace(string, string, ReplaceOptions)

استبدال نص الخلية مع خيارات.

public void Replace(string placeHolder, string newValue, ReplaceOptions options)

المعلمات

placeHolder string

نص العنصر النائب للخلية

newValue string

قيمة السلسلة لاستبدالها

options ReplaceOptions

خيارات الاستبدال

SetArrayFormula(string, int, int)

تعيين صيغة مصفوفة (صيغة مصفوفة قديمة تم إدخالها عبر CTRL+SHIFT+ENTER في Excel) إلى نطاق من الخلايا.

public void SetArrayFormula(string arrayFormula, int rowNumber, int columnNumber)

المعلمات

arrayFormula string

صيغة المصفوفة.

rowNumber int

عدد الصفوف لملء نتائج صيغة المصفوفة.

columnNumber int

عدد الأعمدة لملء نتائج صيغة المصفوفة.

SetArrayFormula(string, int, int, FormulaParseOptions)

تعيين صيغة مصفوفة إلى نطاق من الخلايا.

public void SetArrayFormula(string arrayFormula, int rowNumber, int columnNumber, FormulaParseOptions options)

المعلمات

arrayFormula string

صيغة المصفوفة.

rowNumber int

عدد الصفوف لملء نتائج صيغة المصفوفة.

columnNumber int

عدد الأعمدة لملء نتائج صيغة المصفوفة.

options FormulaParseOptions

خيارات لتحليل الصيغة.

SetArrayFormula(string, int, int, FormulaParseOptions, object[][])

تعيين صيغة مصفوفة إلى نطاق من الخلايا.

public void SetArrayFormula(string arrayFormula, int rowNumber, int columnNumber, FormulaParseOptions options, object[][] values)

المعلمات

arrayFormula string

صيغة المصفوفة.

rowNumber int

عدد الصفوف لملء نتائج صيغة المصفوفة.

columnNumber int

عدد الأعمدة لملء نتائج صيغة المصفوفة.

options FormulaParseOptions

خيارات لتحليل الصيغة.

values object[][]

القيم لتلك الخلايا مع صيغة المصفوفة المعطاة

SetCharacters(FontSetting[])

تعيين تنسيق النص الغني للخلية.

public void SetCharacters(FontSetting[] characters)

المعلمات

characters FontSetting[]

جميع كائنات Characters.

SetDynamicArrayFormula(string, FormulaParseOptions, bool)

تعيين صيغة مصفوفة ديناميكية وجعل الصيغة تتدفق إلى خلايا مجاورة إذا كان ذلك ممكنًا.

public CellArea SetDynamicArrayFormula(string arrayFormula, FormulaParseOptions options, bool calculateValue)

المعلمات

arrayFormula string

تعبير الصيغة

options FormulaParseOptions

خيارات لتحليل الصيغة. سيتم تجاهل خيار “تحليل” وستتم دائمًا معالجة الصيغة على الفور

calculateValue bool

سواء كانت تحسب هذه الصيغة الديناميكية لتلك الخلايا في النطاق المتدفق.

الإرجاع

النطاق الذي يجب أن تتدفق إليه الصيغة.

ملاحظات

قد لا يكون النطاق المعاد هو نفسه النطاق الفعلي الذي تتدفق إليه هذه الصيغة الديناميكية. إذا كانت هناك خلايا غير فارغة في النطاق، فسيتم تعيين الصيغة فقط للخلية الحالية ويتم وضع علامة “#SPILL!”. ولكن لمثل هذه الحالة، لا يزال نعيد النطاق الكامل الذي يجب أن تتدفق إليه هذه الصيغة.

SetDynamicArrayFormula(string, FormulaParseOptions, object[][], bool, bool)

تعيين صيغة مصفوفة ديناميكية وجعل الصيغة تتدفق إلى خلايا مجاورة إذا كان ذلك ممكنًا.

public CellArea SetDynamicArrayFormula(string arrayFormula, FormulaParseOptions options, object[][] values, bool calculateRange, bool calculateValue)

المعلمات

arrayFormula string

تعبير الصيغة

options FormulaParseOptions

خيارات لتحليل الصيغة. سيتم تجاهل خيار “تحليل” وستتم دائمًا معالجة الصيغة على الفور

values object[][]

القيم (النتائج المحسوبة) لتلك الخلايا مع صيغة المصفوفة الديناميكية المعطاة

calculateRange bool

سواء كانت تحسب النطاق المتدفق لهذه الصيغة الديناميكية. إذا كانت المعلمة “values” ليست null وكانت هذه العلامة خاطئة، فسيكون ارتفاع النطاق المتدفق هو values.Length وعرضه هو values[0].Length.

calculateValue bool

سواء كانت تحسب هذه الصيغة الديناميكية لتلك الخلايا في النطاق المتدفق عندما تكون “values” null أو عنصر مطابق في “values” لخلية واحدة هو null.

الإرجاع

النطاق الذي يجب أن تتدفق إليه الصيغة.

ملاحظات

SetDynamicArrayFormula(string, FormulaParseOptions, object[][], bool, bool, CalculationOptions)

تعيين صيغة مصفوفة ديناميكية وجعل الصيغة تتدفق إلى خلايا مجاورة إذا كان ذلك ممكنًا.

public CellArea SetDynamicArrayFormula(string arrayFormula, FormulaParseOptions options, object[][] values, bool calculateRange, bool calculateValue, CalculationOptions copts)

المعلمات

arrayFormula string

تعبير الصيغة

options FormulaParseOptions

خيارات لتحليل الصيغة. سيتم تجاهل خيار “تحليل” وستتم دائمًا معالجة الصيغة على الفور

values object[][]

القيم (النتائج المحسوبة) لتلك الخلايا مع صيغة المصفوفة الديناميكية المعطاة

calculateRange bool

calculateValue bool

copts CalculationOptions

خيارات لحساب الصيغة. عادةً، لأغراض الأداء، يجب أن تكون خاصية Aspose.Cells.CalculationOptions.Recursive خاطئة.

الإرجاع

النطاق الذي يجب أن تتدفق إليه الصيغة.

ملاحظات

SetFormula(string, object)

تعيين الصيغة وقيمة (النتيجة المحسوبة) للصيغة.

public void SetFormula(string formula, object value)

المعلمات

formula string

الصيغة.

value object

القيمة (النتيجة المحسوبة) للصيغة.

SetFormula(string, FormulaParseOptions)

تعيين الصيغة وقيمة (النتيجة المحسوبة) للصيغة.

public void SetFormula(string formula, FormulaParseOptions options)

المعلمات

formula string

الصيغة.

options FormulaParseOptions

خيارات لتحليل الصيغة.

SetFormula(string, FormulaParseOptions, object)

تعيين الصيغة وقيمة (النتيجة المحسوبة) للصيغة.

public void SetFormula(string formula, FormulaParseOptions options, object value)

المعلمات

formula string

الصيغة.

options FormulaParseOptions

خيارات لتحليل الصيغة.

value object

القيمة (النتيجة المحسوبة) للصيغة.

SetSharedFormula(string, int, int)

تعيين الصيغ المشتركة إلى نطاق من الخلايا.

public void SetSharedFormula(string sharedFormula, int rowNumber, int columnNumber)

المعلمات

sharedFormula string

الصيغة المشتركة.

rowNumber int

عدد الصفوف لملء الصيغة.

columnNumber int

عدد الأعمدة لملء الصيغة.

SetSharedFormula(string, int, int, FormulaParseOptions)

تعيين الصيغ المشتركة إلى نطاق من الخلايا.

public void SetSharedFormula(string sharedFormula, int rowNumber, int columnNumber, FormulaParseOptions options)

المعلمات

sharedFormula string

الصيغة المشتركة.

rowNumber int

عدد الصفوف لملء الصيغة.

columnNumber int

عدد الأعمدة لملء الصيغة.

options FormulaParseOptions

خيارات لتحليل الصيغة.

SetSharedFormula(string, int, int, FormulaParseOptions, object[][])

تعيين الصيغ المشتركة إلى نطاق من الخلايا.

public void SetSharedFormula(string sharedFormula, int rowNumber, int columnNumber, FormulaParseOptions options, object[][] values)

المعلمات

sharedFormula string

الصيغة المشتركة.

rowNumber int

عدد الصفوف لملء الصيغة.

columnNumber int

عدد الأعمدة لملء الصيغة.

options FormulaParseOptions

خيارات لتحليل الصيغة.

values object[][]

القيم لتلك الخلايا مع الصيغة المشتركة المعطاة

SetStyle(Style)

تعيين نمط الخلية.

public void SetStyle(Style style)

المعلمات

style Style

نمط الخلية.

ملاحظات

إذا تم تغيير إعدادات الحدود، فسيتم تحديث حدود الخلايا المعدلة أيضًا.

SetStyle(Style, bool)

تطبيق الخاصية المعدلة للنمط على الخلية.

public void SetStyle(Style style, bool explicitFlag)

المعلمات

style Style

نمط الخلية.

explicitFlag bool

صحيح، فقط الكتابة فوق التنسيق الذي تم تعيينه بشكل صريح.

SetStyle(Style, StyleFlag)

تطبيق نمط الخلية بناءً على العلامات.

public void SetStyle(Style style, StyleFlag flag)

المعلمات

style Style

نمط الخلية.

flag StyleFlag

علامة النمط.

SetTableFormula(int, int, string, string, object[][])

إنشاء جدول بيانات ثنائي المتغير للنطاق المعطى بدءًا من هذه الخلية.

public void SetTableFormula(int rowNumber, int columnNumber, string rowInputCell, string columnInputCell, object[][] values)

المعلمات

rowNumber int

عدد الصفوف لملء الصيغة.

columnNumber int

عدد الأعمدة لملء الصيغة.

rowInputCell string

خلية الإدخال الصف.

columnInputCell string

خلية الإدخال العمود.

values object[][]

القيم للخلايا في نطاق صيغة الجدول

SetTableFormula(int, int, string, bool, object[][])

إنشاء جدول بيانات أحادي المتغير للنطاق المعطى بدءًا من هذه الخلية.

public void SetTableFormula(int rowNumber, int columnNumber, string inputCell, bool isRowInput, object[][] values)

المعلمات

rowNumber int

عدد الصفوف لملء الصيغة.

columnNumber int

عدد الأعمدة لملء الصيغة.

inputCell string

خلية الإدخال.

isRowInput bool

تشير إلى ما إذا كانت خلية الإدخال هي خلية إدخال صف (صحيح) أو خلية إدخال عمود (خطأ).

values object[][]

القيم للخلايا في نطاق صيغة الجدول

SetTableFormula(int, int, int, int, int, int, object[][])

إنشاء جدول بيانات ثنائي المتغير للنطاق المعطى بدءًا من هذه الخلية.

public void SetTableFormula(int rowNumber, int columnNumber, int rowIndexOfRowInputCell, int columnIndexOfRowInputCell, int rowIndexOfColumnInputCell, int columnIndexOfColumnInputCell, object[][] values)

المعلمات

rowNumber int

عدد الصفوف لملء الصيغة.

columnNumber int

عدد الأعمدة لملء الصيغة.

rowIndexOfRowInputCell int

فهرس الصف لخلية إدخال الصف.

columnIndexOfRowInputCell int

فهرس العمود لخلية إدخال الصف.

rowIndexOfColumnInputCell int

فهرس الصف لخلية إدخال العمود.

columnIndexOfColumnInputCell int

فهرس العمود لخلية إدخال العمود.

values object[][]

القيم للخلايا في نطاق صيغة الجدول

SetTableFormula(int, int, int, int, bool, object[][])

إنشاء جدول بيانات أحادي المتغير للنطاق المعطى بدءًا من هذه الخلية.

public void SetTableFormula(int rowNumber, int columnNumber, int rowIndexOfInputCell, int columnIndexOfInputCell, bool isRowInput, object[][] values)

المعلمات

rowNumber int

عدد الصفوف لملء الصيغة.

columnNumber int

عدد الأعمدة لملء الصيغة.

rowIndexOfInputCell int

فهرس الصف لخلية الإدخال.

columnIndexOfInputCell int

فهرس العمود لخلية الإدخال.

isRowInput bool

تشير إلى ما إذا كانت خلية الإدخال هي خلية إدخال صف (صحيح) أو خلية إدخال عمود (خطأ).

values object[][]

القيم للخلايا في نطاق صيغة الجدول

ToJson()

تحويل Aspose.Cells.Cell إلى بيانات هيكل JSON.

public string ToJson()

الإرجاع

ToString()

يعيد سلسلة تمثل كائن Cell الحالي.

public override string ToString()

الإرجاع