OLE signifie Liaison et incorporation d’objets. Il est fourni par Microsoft et vous permet de créer et de modifier des documents contenant des éléments ou des objets créés par diverses applications.
Par exemple, vous pouvez incorporer des feuilles de calcul, des images et des clips audio en tant qu’objets OLE dans un document Word. Vous pouvez utiliser ces objets OLE dans le document Word et ne vous inquiétez pas de basculer encore et encore vers plusieurs applications. Vous pouvez incorporer ou insérer de tels objets par programmation à l’aide d’OLE en C#.
Cet article vous guidera sur la façon dont vous pouvez :
- Insérer un objet OLE dans des documents MS Word
- Insérer un objet OLE dans des feuilles de calcul Excel
- Ajouter un objet OLE dans les présentations PowerPoint
Les étapes de cet article et les exemples de code utilisent GroupDocs.Merger for .NET. Assurez-vous donc d’installer l’API à partir de l’une des méthodes suivantes :
- Installez à l’aide de NuGet Gestionnaire de packages.
- Téléchargez la DLL et référencez-la dans le projet.
Insérer un PDF en tant qu’objet OLE dans un document MS Word en C
Voici les étapes et un exemple de code C# pour montrer comment intégrer un fichier PDF dans un document Word en tant qu’objet OLE :
- Instanciez OleWordProcessingOptions avec les options d’incorporation et le document à incorporer dans un document Word.
- Instanciez maintenant l’objet Merger avec le chemin ou le flux du document Word source.
- Appelez la méthode ImportDocument et transmettez l’objet des Options de traitement de texte OLE définies à l’étape 1.
- C’est ça. Appelez la méthode Save pour obtenir le document Word résultant ayant un document PDF comme objet 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");
}
Insérer un document Word en tant qu’objet OLE dans une feuille de calcul Excel en C#
Nous pouvons intégrer des objets OLE dans des feuilles de calcul Excel. Exemple de code CSharp et étapes ci-dessous expliquant comment ajouter un document Word dans une feuille de calcul Excel en tant qu’objet OLE :
- Instanciez OleSpreadsheetOptions avec les options d’intégration et le document à intégrer dans une feuille de calcul Excel.
- Instanciez maintenant l’objet Merger avec le chemin ou le flux source Spreadsheet.
- Appelez maintenant la méthode ImportDocument et transmettez l’objet OLE Spreadsheet Options défini à l’étape 1.
- Enfin, appelez la méthode Save pour obtenir la feuille de calcul Excel résultante ayant un document Word comme objet 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");
}
Ajouter un PDF en tant qu’objet OLE à une présentation PowerPoint en C#
De même, nous insérons ici des objets dans une présentation PowerPoint.
- Instanciez OlePresentationOptions avec les options d’intégration et le document à intégrer dans une présentation PowerPoint.
- Instanciez maintenant l’objet Merger avec le chemin ou le flux source Presentation.
- Appelez la méthode ImportDocument et transmettez l’objet des Options de présentation OLE définies à l’étape 1.
- Enfin, appelez la méthode Save pour obtenir la présentation PowerPoint résultante avec un document PDF en tant qu’objet 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");
}
Conclusion
Nous avons discuté de la facilité et de la rapidité avec lesquelles nous pouvons insérer des objets OLE dans des documents Word, Excel ou PowerPoint par programme en C#. Il n’y a qu’une petite différence de code pour chaque objectif, c’est-à-dire une classe d’options OLE différente et ses options pour chaque format de fichier :
- OleWordProcessingOptions pour incorporer des objets OLE dans un document Word.
- OleSpreadsheetOptions pour incorporer des objets OLE dans Excel Spreadsheets.
- OlePresentationOptions pour incorporer des objets OLE dans la présentation PowerPoint.
Vous pouvez en savoir plus sur l’API à partir de la documentation ou Parlons plus @ Forum de support gratuit.