Range

Range class

لتغليف الكائن الذي يمثل نطاقًا من الخلايا داخل جدول بيانات.

public class Range

الخصائص

اسموصف
Address { get; }يحصل على عنوان النطاق .
ColumnCount { get; }الحصول على عدد الأعمدة في النطاق .
ColumnWidth { get; set; }تعيين عرض العمود لهذا النطاق أو الحصول عليه
CurrentRegion { get; }إرجاع كائن النطاق الذي يمثل المنطقة الحالية. المنطقة الحالية هي نطاق محدد بأي مجموعة من الصفوف والأعمدة الفارغة.
EntireColumn { get; }الحصول على كائن نطاق يمثل العمود (أو الأعمدة) بأكمله الذي يحتوي على النطاق المحدد.
EntireRow { get; }الحصول على كائن نطاق يمثل الصف (أو الصفوف) بأكملها التي تحتوي على النطاق المحدد.
FirstColumn { get; }يحصل على فهرس العمود الأول من النطاق.
FirstRow { get; }يحصل على فهرس الصف الأول من النطاق .
Height { get; }الحصول على عرض النطاق بالنقاط.
Hyperlinks { get; }يحصل على كل الارتباطات التشعبية في النطاق .
Item { get; }يحصلCell كائن في هذا النطاق.
Left { get; }الحصول على المسافة ، بالنقاط ، من الحافة اليسرى للعمود A إلى الحافة اليسرى للنطاق .
Name { get; set; }الحصول على أو تحديد اسم النطاق .
RefersTo { get; }يحصل على النطاق الذي يشير إليه .
RowCount { get; }الحصول على عدد الصفوف في النطاق .
RowHeight { get; set; }تعيين ارتفاع الصفوف أو الحصول عليها في هذا النطاق
Top { get; }الحصول على المسافة ، بالنقاط ، من الحافة العلوية للصف 1 إلى الحافة العلوية للنطاق .
Value { get; set; }الحصول على قيمة النطاق وتعيينها.
Width { get; }الحصول على عرض النطاق بالنقاط.
Worksheet { get; }يحصل على ملفWorksheet الكائن الذي يحتوي على هذا النطاق.

طُرق

اسموصف
ApplyStyle(Style, StyleFlag)يطبق التنسيقات على نطاق كامل .
AutoFill(Range)كل ملء النطاق المستهدف.
AutoFill(Range, AutoFillType)كل ملء النطاق المستهدف.
Copy(Range)نسخ البيانات (بما في ذلك الصيغ) والتنسيق والكائنات الرسومية وما إلى ذلك من نطاق مصدر.
Copy(Range, PasteOptions)نسخ النطاق باستخدام خيارات اللصق الخاصة.
CopyData(Range)نسخ بيانات الخلية (بما في ذلك الصيغ) من نطاق مصدر .
CopyStyle(Range)نسخ إعدادات النمط من نطاق مصدر .
CopyValue(Range)ينسخ قيمة الخلية من نطاق مصدر .
ExportDataTable()لتصدير البيانات في هذا النطاق إلى ملفDataTable الكائن .
ExportDataTable(ExportTableOptions)لتصدير البيانات في هذا النطاق إلى ملفDataTable الكائن .
ExportDataTableAsString()لتصدير البيانات في هذا النطاق إلى ملفDataTable الكائن .
GetCellOrNull(int, int)يحصلCell كائن أو فارغ في هذا النطاق.
GetEnumerator()الحصول على العداد للخلايا في هذا النطاق .
GetOffset(int, int)يحصلRange النطاق عن طريق الإزاحة.
Intersect(Range)إرجاع أRange يمثل التقاطع المستطيل لنطاقين.
IsIntersect(Range)يشير إلى ما إذا كان النطاق متقاطعًا.
Merge()دمج نطاق من الخلايا في خلية واحدة.
MoveTo(int, int)انقل النطاق الحالي إلى النطاق المصدق .
PutValue(string, bool, bool)يضع قيمة في النطاق ، إذا كان ذلك مناسبًا ، فسيتم تحويل القيمة إلى نوع بيانات آخر وستتم إعادة تعيين تنسيق رقم الخلية.
SetInsideBorders(BorderType, CellBorderType, CellsColor)تعيين الحدود الداخلية للنطاق .
SetOutlineBorder(BorderType, CellBorderType, Color)يعين حدود المخطط حول نطاق من الخلايا.
SetOutlineBorders(CellBorderType, Color)تعيين حدود المخطط التفصيلي حول نطاق من الخلايا بنفس نمط ولون الحدود.
SetOutlineBorders(CellBorderType[], Color[])تعيين حدود الخط حول نطاق من الخلايا.
SetStyle(Style)يضبط نمط النطاق .
override ToString()إرجاع سلسلة تمثل كائن النطاق الحالي.
Union(Range)إرجاع اتحاد نطاقين .
UnMerge()يقوم بإلغاء دمج الخلايا المدمجة من هذا النطاق.

أمثلة


[C#]

// إنشاء كائن مصنف
Workbook workbook = new Workbook();
// احصل على خلايا ورقة العمل الأولى.
Cells cells = workbook.Worksheets[0].Cells;
// قم بإنشاء نطاق (A1: D3).
Range range = cells.CreateRange("A1", "D3");
// تعيين القيمة إلى النطاق.
range.Value = "Hello";
// احفظ ملف Excel
workbook.Save("book1.xlsm");

 [Visual Basic]

'إنشاء كائن مصنف
Dim workbook As Workbook = New Workbook()
'احصل على خلايا ورقة العمل الأولى.
Dim cells as Cells = workbook.Worksheets[0].Cells
'قم بإنشاء نطاق (A1: D3).
Dim range as Range = cells.CreateRange("A1", "D3")
'اضبط القيمة على النطاق.
range.Value = "Hello"
'احفظ ملف Excel
workbook.Save("book1.xlsm")

أنظر أيضا

QueryTableCollection RangeCollection