OLE oznacza Łączenie i osadzanie obiektów. Jest dostarczany przez firmę Microsoft i umożliwia tworzenie i edytowanie dokumentów zawierających elementy lub obiekty tworzone przez różne aplikacje.

Na przykład możesz osadzać arkusze kalkulacyjne, obrazy i klipy dźwiękowe jako obiekty OLE w dokumencie programu Word. Tych obiektów OLE można używać w dokumencie programu Word i nie trzeba się martwić ciągłym przełączaniem do wielu aplikacji. Takie obiekty można osadzać lub wstawiać programowo przy użyciu technologii OLE w języku C#.

Z tego artykułu dowiesz się, jak możesz:

Kroki opisane w tym artykule i przykłady kodu wykorzystują GroupDocs.Merger for .NET. Upewnij się więc, że zainstalowałeś interfejs API za pomocą jednej z następujących metod:

  • Zainstaluj za pomocą Menedżera pakietów NuGet.
  • Pobierać the DLL and reference it into the project.

Wstaw PDF jako obiekt OLE do dokumentu MS Word w C#

Wstaw PDF jako OLE w dokumencie Word w C#

Oto kroki i przykładowy kod C#, aby pokazać, jak osadzić plik PDF w dokumencie programu Word jako obiekt OLE:

  1. Utwórz instancję OleWordProcessingOptions z opcjami osadzania i dokumentem do osadzenia w dokumencie programu Word.
  2. Teraz utwórz instancję obiektu Merger ze ścieżką lub strumieniem źródłowego dokumentu Word.
  3. Wywołaj metodę ImportDocument i przekaż obiekt OLE Word Processing Options ustawiony w kroku 1.
  4. Otóż to. Wywołaj metodę Save, aby uzyskać wynikowy dokument programu Word zawierający dokument PDF jako obiekt 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");
}

Wstaw dokument programu Word jako obiekt OLE do arkusza kalkulacyjnego Excel w języku C#

Wstaw plik Word s OLE do arkusza kalkulacyjnego Excel w C#

Możemy osadzać obiekty OLE w arkuszach kalkulacyjnych Excel. Przykładowy kod CSharp i poniższe kroki wyjaśniające, jak dodać dokument programu Word do arkusza kalkulacyjnego programu Excel jako obiekt OLE:

  1. Utwórz instancję OleSpreadsheetOptions z opcjami osadzania i dokumentu do osadzenia w arkuszu kalkulacyjnym Excel.
  2. Teraz utwórz instancję obiektu Merger ze źródłową ścieżką lub strumieniem arkusza kalkulacyjnego.
  3. Teraz wywołaj metodę ImportDocument i przekaż obiekt OLE Spreadsheet Options ustawiony w kroku 1.
  4. Na koniec wywołaj metodę Save, aby uzyskać wynikowy arkusz kalkulacyjny programu Excel zawierający dokument programu Word jako obiekt 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");
}

Dodaj PDF jako obiekt OLE do prezentacji PowerPoint w C#

Wstaw PDF jako OLE w prezentacji PowerPoint w C#

Podobnie tutaj wstawiamy obiekty w prezentacji PowerPoint.

  1. Utwórz instancję OlePresentationOptions z opcjami osadzania i dokumentu do osadzenia w prezentacji programu PowerPoint.
  2. Teraz utwórz instancję obiektu Merger ze źródłową ścieżką lub strumieniem prezentacji.
  3. Wywołaj metodę ImportDocument i przekaż obiekt opcji prezentacji OLE ustawiony w kroku 1.
  4. Na koniec wywołaj metodę Save, aby uzyskać wynikową prezentację PowerPoint z dokumentem PDF jako obiektem 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");
}

Wniosek

Omówiliśmy, jak łatwo i szybko możemy programowo wstawiać obiekty OLE w dokumentach Word, Excel lub PowerPoint w języku C#. Istnieje tylko niewielka różnica w kodzie dla każdego celu, tj. inna klasa opcji OLE i jej opcje dla każdego formatu pliku:

  • OleWordProcessingOptions do osadzania obiektów OLE w dokumencie programu Word.
  • OleSpreadsheetOpcje osadzania obiektów OLE w arkuszach kalkulacyjnych Excel.
  • OlePresentationOptions do osadzania obiektów OLE w prezentacji PowerPoint.

Możesz dowiedzieć się więcej o interfejsie API z dokumentacji lub Porozmawiajmy więcej na Free Support Forum.