إدراج كائنات OLE في Word و Excel و PowerPoint باستخدام C #

يرمز OLE إلى ارتباط الكائنات وتضمينها. يتم توفيره من قبل Microsoft ويسمح لك بإنشاء وتحرير المستندات التي تحتوي على عناصر أو كائنات تم إنشاؤها بواسطة تطبيقات مختلفة.

كمثال ، يمكنك تضمين جداول البيانات والصور ومقاطع الصوت ككائنات OLE في مستند Word. يمكنك استخدام كائنات OLE هذه في مستند Word ولا تقلق بشأن التبديل إلى تطبيقات متعددة مرارًا وتكرارًا. يمكنك تضمين أو إدراج هذه الكائنات برمجيًا باستخدام OLE في C #.

ستوجهك هذه المقالة حول كيفية القيام بما يلي:

• أدخل كائن OLE في مستندات MS Word
• أدخل كائن OLE في جداول بيانات Excel
• أضف كائن OLE إلى عروض PowerPoint التقديمية

تستخدم الخطوات الواردة في هذه المقالة ونماذج التعليمات البرمجية GroupDocs.Merger for .NET. لذا يرجى التأكد من تثبيت API من أي من الطرق التالية:

• التثبيت باستخدام NuGet مدير الحزم.
• تحميل the DLL and reference it into the project.

أدخل PDF ككائن OLE في مستند MS Word في C

فيما يلي الخطوات ونموذج التعليمات البرمجية C # لإظهار كيفية تضمين ملف PDF في مستند Word ككائن OLE:

1. إنشاء OleWordProcessingOptions مع خيارات التضمين والمستند المراد تضمينه في مستند Word.
2. الآن قم بإنشاء مثيل لكائن دمج بمسار أو دفق مستند Word المصدر.
3. قم باستدعاء الأسلوب ImportDocument وقم بتمرير كائن OLE Word Processing Options التي تم تعيينها في الخطوة 1.
4. هذا هو. قم باستدعاء طريقة حفظ للحصول على مستند Word الناتج الذي يحتوي على مستند PDF ككائن OLE.

// Embed a PDF file into a Word document as an OLE Object in C#
int pageNumber = 2;
OleWordProcessingOptions oleWordProcessingOptions = new OleWordProcessingOptions(@"embedded-doc.pdf", pageNumber)
{ 
    Width = 300, // Just setting the height & width, you have more options.
    Height = 300
};
// Use Merger class to start with source Word document and embed PDF as OLE object.
using (Merger merger = new Merger(@"source-doc.docx"))
{
    merger.ImportDocument(oleWordProcessingOptions);
    merger.Save(@"word-document-with-OLE.docx");
}

أدخل مستند Word ككائن OLE في جدول بيانات Excel في C

يمكننا تضمين كائنات OLE في جداول بيانات Excel. نموذج CSharp Code والخطوات أدناه تشرح كيفية إضافة مستند Word إلى جدول بيانات Excel ككائن OLE:

1. إنشاء مثيل OleSpreadsheetOptions مع خيارات التضمين والمستند المراد تضمينه في جدول بيانات Excel.
2. الآن قم بإنشاء مثيل لكائن دمج بمسار جدول البيانات المصدر أو الدفق.
3. الآن قم باستدعاء طريقة ImportDocument وقم بتمرير كائن OLE Spreadsheet Options التي تم تعيينها في الخطوة 1.
4. أخيرًا ، قم باستدعاء طريقة حفظ للحصول على جدول بيانات Excel الناتج الذي يحتوي على مستند Word ككائن OLE.

// Embed a Word file into an Excel Spreadsheet as an OLE Object in C#
int pageNumber = 2;
OleSpreadsheetOptions oleSpreadsheetOptions = new OleSpreadsheetOptions(@"embedded-doc.docx", pageNumber)
{
    RowIndex = 2, // Setting the Row & height Index, you have more options.
    ColumnIndex = 2
};
// Using Merger class with source spreadsheet and embedding a Word document as an OLE object.
using (Merger merger = new Merger(@"sample-doc.xlsx"))
{
    merger.ImportDocument(oleSpreadsheetOptions);
    merger.Save(@"excel-sheet-with-ole.xlsx");
}

إضافة PDF ككائن OLE إلى عرض تقديمي في PowerPoint في C

وبالمثل ، نحن هنا نقوم بإدراج كائنات في عرض تقديمي لـ PowerPoint.

1. إنشاء OlePresentationOptions مع خيارات التضمين والمستند المراد تضمينه في عرض تقديمي لـ PowerPoint.
2. الآن قم بإنشاء مثيل لكائن دمج بمسار أو دفق العرض التقديمي المصدر.
3. قم باستدعاء الأسلوب ImportDocument وقم بتمرير كائن OLE Presentation Options التي تم تعيينها في الخطوة 1.
4. أخيرًا ، قم باستدعاء طريقة Save للحصول على عرض PowerPoint التقديمي الناتج مع مستند PDF ككائن OLE.

// Embed a PDF file into an Excel Spreadsheet as an OLE Object in C#
int pageNumber = 2;
OlePresentationOptions olePresentationOptions = new OlePresentationOptions(@"embedded.pdf", pageNumber)
{
    X = 10, // Setting only X & Y coordinates, you can customize more.
    Y = 10
};
// Using Merger class to embed a PDF file as an OLE object in the PowerPoint presentation.
using (Merger merger = new Merger(@"sample-presentation.ppt"))
{
    merger.ImportDocument(olePresentationOptions);
    merger.Save(@"powerpoint-presentation-with-ole.ppt");
}

استنتاج

لقد ناقشنا مدى سهولة وسرعة إدراج كائنات OLE في مستندات Word أو Excel أو PowerPoint برمجيًا في C #. لا يوجد سوى اختلاف بسيط في الكود لكل هدف ، أي فئة خيارات OLE المختلفة وخياراتها لكل تنسيق ملف:

• OleWordProcessingOptions لتضمين كائنات OLE في مستند Word.
• OleSpreadsheetOptions لتضمين كائنات OLE في جداول بيانات Excel.
• OlePresentationOptions لتضمين كائنات OLE في عرض PowerPoint التقديمي.

يمكنك معرفة المزيد حول API من الوثائق أو Let’s talk more @ Free Support Forum.