درج اشیاء OLE در ورد، اکسل، پاورپوینت با سی شارپ

OLE مخفف Object Linking and Embedding است. این توسط مایکروسافت ارائه شده است و به شما امکان می دهد اسنادی حاوی موارد یا اشیاء ایجاد شده توسط برنامه های مختلف ایجاد و ویرایش کنید.

به عنوان مثال، می توانید صفحات گسترده، تصاویر و کلیپ های صوتی را به عنوان اشیاء OLE در یک سند Word جاسازی کنید. می توانید از این اشیاء OLE در سند Word استفاده کنید و نگران جابجایی مجدد به چندین برنامه نباشید. شما می توانید با استفاده از OLE در سی شارپ، چنین اشیایی را به صورت برنامه ریزی شده جاسازی یا درج کنید.

این مقاله شما را راهنمایی می کند که چگونه می توانید:

• شی OLE را در اسناد MS Word قرار دهید
• شی OLE را در صفحات گسترده اکسل قرار دهید
• شی OLE را به ارائه های پاورپوینت اضافه کنید

مراحل این مقاله و نمونه کد از GroupDocs.Merger for .NET استفاده می کنند. بنابراین لطفاً مطمئن شوید که API را از یکی از روش های زیر نصب کنید:

• با استفاده از NuGet Package Manager نصب کنید.
• دانلود the DLL and reference it into the project.

درج PDF به عنوان Object OLE در سند MS Word در C#

در اینجا مراحل و نمونه کد C# برای نشان دادن نحوه جاسازی یک فایل PDF در یک سند Word به عنوان یک شی OLE آمده است:

1. OleWordProcessingOptions را با گزینه‌های جاسازی و سندی که باید در یک سند Word جاسازی کنید، نمونه‌سازی کنید.
2. اکنون شیء Merger را با مسیر سند منبع Word یا جریان نمونه‌سازی کنید.
3. متد ImportDocument را فراخوانی کنید و شیء OLE Word Processing Options را که در مرحله 1 تنظیم شده است، ارسال کنید.
4. خودشه. روش Save را فراخوانی کنید تا سند 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 در صفحه گسترده اکسل در C#

ما می توانیم اشیاء OLE را در صفحات گسترده اکسل جاسازی کنیم. نمونه کد CSharp و مراحل زیر توضیح می دهد که چگونه یک سند Word را به عنوان یک شی OLE به صفحه گسترده اکسل اضافه کنید:

1. OleSpreadsheetOptions را با گزینه‌های جاسازی و سند برای جاسازی در صفحه‌گسترده اکسل نمونه‌سازی کنید.
2. اکنون شیء Merger را با مسیر صفحه‌گسترده منبع یا جریان نمونه‌سازی کنید.
3. اکنون متد ImportDocument را فراخوانی کنید و شیء OLE Spreadsheet Options را که در مرحله 1 تنظیم شده است، ارسال کنید.
4. در نهایت، روش Save را فراخوانی کنید تا صفحه گسترده اکسل حاصل از یک سند 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 به عنوان Object OLE به ارائه پاورپوینت در C#

به طور مشابه، در اینجا ما در حال درج اشیاء در یک ارائه پاورپوینت هستیم.

1. OlePresentationOptions را با گزینه‌های جاسازی و سندی که باید در یک ارائه پاورپوینت جاسازی کنید، نمونه‌سازی کنید.
2. اکنون شیء Merger را با مسیر یا جریان منبع ارائه نمونه‌سازی کنید.
3. متد ImportDocument را فراخوانی کنید و شیء OLE Presentation Options را که در مرحله 1 تنظیم شده است ارسال کنید.
4. در نهایت، روش Save را فراخوانی کنید تا ارائه پاورپوینت حاصل را با یک سند 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 را در اسناد ورد، اکسل یا پاورپوینت به صورت برنامه نویسی در C# وارد کنیم. فقط یک تفاوت کوچک در کد برای هر هدف وجود دارد، یعنی کلاس گزینه های OLE مختلف و گزینه های آن برای هر فرمت فایل:

• OleWordProcessingOptions برای جاسازی اشیاء OLE در یک سند Word.
• OleSpreadsheetOptions برای جاسازی اشیاء OLE در صفحات گسترده اکسل.
• OlePresentationOptions برای جاسازی اشیاء OLE در ارائه پاورپوینت.

می‌توانید از مستندات درباره API بیشتر بیاموزید یا بیایید بیشتر صحبت کنیم @ Free Support Forum.