FieldDatabase
محتويات
[
يخفي
]FieldDatabase class
ينفذ حقل قاعدة البيانات.
لمعرفة المزيد، قم بزيارةالعمل مع الحقول مقالة توثيقية.
public class FieldDatabase : Field
المنشئون
| اسم | وصف |
|---|---|
| FieldDatabase() | Default_Constructor |
الخصائص
| اسم | وصف |
|---|---|
| Connection { get; set; } | يحصل على اتصال بالبيانات أو يعينه. |
| DisplayResult { get; } | يحصل على النص الذي يمثل نتيجة الحقل المعروضة. |
| End { get; } | يحصل على العقدة التي تمثل نهاية الحقل. |
| FileName { get; set; } | يحصل على المسار الكامل واسم الملف لقاعدة البيانات أو يعينه |
| FirstRecord { get; set; } | يحصل على رقم السجل الصحيح لسجل البيانات الأول الذي سيتم إدراجه أو يعينه. |
| Format { get; } | يحصل علىFieldFormatالكائن الذي يوفر الوصول المكتوب إلى تنسيق الحقل. |
| FormatAttributes { get; set; } | يحصل على أو يعين السمات التي سيتم تطبيقها على الجدول. |
| InsertHeadings { get; set; } | يحصل على أو يحدد ما إذا كان سيتم إدراج أسماء الحقول من قاعدة البيانات كعناوين أعمدة في الجدول الناتج. |
| InsertOnceOnMailMerge { get; set; } | يحصل على أو يحدد ما إذا كان سيتم إدراج البيانات في بداية الدمج. |
| IsDirty { get; set; } | يحصل على أو يحدد ما إذا كانت النتيجة الحالية للحقل لم تعد صحيحة (قديمة) بسبب التعديلات الأخرى التي تم إجراؤها على المستند. |
| IsLocked { get; set; } | يحصل على أو يحدد ما إذا كان الحقل مقفلاً (لا ينبغي إعادة حساب نتيجته). |
| LastRecord { get; set; } | يحصل على رقم السجل الصحيح لسجل البيانات الأخير المراد إدراجه أو يعينه. |
| LocaleId { get; set; } | يحصل على أو يعين LCID للحقل. |
| Query { get; set; } | يحصل على مجموعة من تعليمات SQL التي تستفسر عن قاعدة البيانات أو يعينها. |
| Result { get; set; } | يحصل على النص الموجود بين فاصل الحقل ونهاية الحقل أو يعينه. |
| Separator { get; } | يحصل على العقدة التي تمثل فاصل الحقل. يمكن أن يكونباطل . |
| Start { get; } | يحصل على العقدة التي تمثل بداية الحقل. |
| TableFormat { get; set; } | يحصل على التنسيق الذي سيتم تطبيقه على نتيجة استعلام قاعدة البيانات أو يعينه. |
| virtual Type { get; } | يحصل على نوع حقل Microsoft Word. |
طُرق
| اسم | وصف |
|---|---|
| GetFieldCode() | يعيد النص بين بداية الحقل وفاصل الحقل (أو نهاية الحقل إذا لم يكن هناك فاصل). يتم تضمين كل من رمز الحقل ونتيجة الحقل للحقول الفرعية. |
| GetFieldCode(bool) | إرجاع النص بين بداية الحقل وفاصل الحقل (أو نهاية الحقل إذا لم يكن هناك فاصل). |
| Remove() | يُزيل الحقل من المستند. يُرجع عقدة بعد الحقل مباشرةً. إذا كانت نهاية الحقل هي آخر عقدة فرعية للعقدة الأصلية، تُرجع فقرته الأصلية. إذا كان الحقل قد حُذف مُسبقًا، تُرجعباطل . |
| Unlink() | يقوم بإلغاء ربط الحقل. |
| Update() | يُجري تحديث الحقل. يُطرح هذا الخطأ إذا كان الحقل قيد التحديث بالفعل. |
| Update(bool) | يُجري تحديثًا للحقل. يُطرح هذا الخطأ إذا كان الحقل قيد التحديث بالفعل. |
ملاحظات
يقوم بإدراج نتائج استعلام قاعدة البيانات في جدول WordprocessingML.
أمثلة
يوضح كيفية استخراج البيانات من قاعدة البيانات وإدراجها كحقل في مستند.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// سيقوم حقل قاعدة البيانات هذا بتشغيل استعلام على قاعدة البيانات، وعرض النتيجة في جدول.
FieldDatabase field = (FieldDatabase)builder.InsertField(FieldType.FieldDatabase, true);
field.FileName = DatabaseDir + "Northwind.accdb";
field.Connection = "Provider=Microsoft.ACE.OLEDB.12.0";
field.Query = "SELECT * FROM [Products]";
Assert.AreEqual($" DATABASE \\d {DatabaseDir.Replace("\\", "\\\\") + "Northwind.accdb"} \\c Provider=Microsoft.ACE.OLEDB.12.0 \\s \"SELECT * FROM [Products]\"", field.GetFieldCode());
// قم بإدراج حقل قاعدة بيانات آخر باستخدام استعلام أكثر تعقيدًا يقوم بفرز جميع المنتجات بترتيب تنازلي حسب إجمالي المبيعات.
field = (FieldDatabase)builder.InsertField(FieldType.FieldDatabase, true);
field.FileName = DatabaseDir + "Northwind.accdb";
field.Connection = "Provider=Microsoft.ACE.OLEDB.12.0";
field.Query =
"SELECT [Products].ProductName, FORMAT(SUM([Order Details].UnitPrice * (1 - [Order Details].Discount) * [Order Details].Quantity), 'Currency') AS GrossSales " +
"FROM([Products] " +
"LEFT JOIN[Order Details] ON[Products].[ProductID] = [Order Details].[ProductID]) " +
"GROUP BY[Products].ProductName " +
"ORDER BY SUM([Order Details].UnitPrice* (1 - [Order Details].Discount) * [Order Details].Quantity) DESC";
// هذه الخصائص لها نفس وظيفة جملتي LIMIT وTOP.
// قم بتكوينها لعرض الصفوف من 1 إلى 10 فقط من نتيجة الاستعلام في جدول الحقل.
field.FirstRecord = "1";
field.LastRecord = "10";
// هذه الخاصية هي فهرس التنسيق الذي نريد استخدامه لجدولنا. قائمة تنسيقات الجدول موجودة في قائمة "تنسيق الجدول تلقائيًا..."
// يظهر هذا عند إنشاء حقل قاعدة بيانات في مايكروسوفت وورد. الفهرس رقم ١٠ يتوافق مع تنسيق "Colorful 3".
field.TableFormat = "10";
// خاصية FormatAttribute عبارة عن تمثيل سلسلة لعدد صحيح يخزن أعلامًا متعددة.
// يمكننا تطبيق التنسيق الذي تشير إليه خاصية TableFormat بشكل أصيل عن طريق تعيين علامات مختلفة في هذه الخاصية.
// الرقم الذي نستخدمه هو مجموع مجموعة من القيم المقابلة لجوانب مختلفة من نمط الجدول.
// 63 يمثل 1 (الحدود) + 2 (التظليل) + 4 (الخط) + 8 (اللون) + 16 (التوافق التلقائي) + 32 (صفوف العناوين).
field.FormatAttributes = "63";
field.InsertHeadings = true;
field.InsertOnceOnMailMerge = true;
doc.FieldOptions.FieldDatabaseProvider = new OleDbFieldDatabaseProvider();
doc.UpdateFields();
doc.Save(ArtifactsDir + "Field.DATABASE.docx");
أنظر أيضا
- class Field
- مساحة الاسم Aspose.Words.Fields
- المجسم Aspose.Words
