Jak osadzić PDF w Excelu przy użyciu GroupDocs.Merger dla .NET

Wprowadzenie

Embedding PDF in Excel lets you keep supporting documents—such as contracts, reports, or specifications—right where the data lives. With GroupDocs.Merger for .NET, you can add OLE objects to cells in just a few lines of code, turning a plain spreadsheet into an interactive, self‑contained workbook. This tutorial walks you through everything you need to know, from installation to troubleshooting.

What you’ll learn

  • How to set up GroupDocs.Merger for .NET in a C# project
  • The exact steps to embed a PDF (or any OLE‑compatible file) into an Excel cell
  • Configuration options, performance tips, and common pitfalls

Let’s confirm you have everything ready before we start.

Szybkie odpowiedzi

  • Czy mogę osadzić dowolny typ pliku? Tak — każdy format obsługiwany jako obiekt OLE (PDF, Word, obraz itp.).
  • Czy potrzebuję licencji do rozwoju? Bezpłatna wersja próbna działa do testów; stała licencja jest wymagana w produkcji.
  • Jakie wersje .NET są obsługiwane? .NET Framework 4.5+, .NET Core 3.1+, .NET 5/6/7+.
  • Czy rozmiar pliku Excel znacznie się zwiększy? Tylko o rozmiar osadzonego dokumentu; aby uzyskać najlepszą wydajność, trzymaj pliki poniżej kilku MB.
  • Czy istnieje limit liczby obiektów OLE? Praktycznie brak, ale bardzo duże skoroszyty mogą wpływać na czas ładowania.

Co to jest osadzanie PDF w Excelu?

Osadzanie PDF w Excelu wstawia cały plik PDF jako obiekt OLE, który można otworzyć bezpośrednio z arkusza kalkulacyjnego. Użytkownicy klikają ikonę i przeglądają oryginalny dokument bez opuszczania Excela. Takie podejście zachowuje pierwotny układ, umożliwia szybkie odwołanie i eliminuje konieczność zarządzania oddzielnymi plikami. Osadzony PDF zachowuje się jak każdy inny obiekt OLE, pozwalając użytkownikom dwukrotnie kliknąć ikonę, aby uruchomić przeglądarkę PDF, pozostając w środowisku Excela.

Dlaczego osadzać obiekty OLE w Excelu?

GroupDocs.Merger obsługuje ponad 120 formatów wejściowych i wyjściowych i może osadzać obiekty bez ładowania całego pliku do pamięci, co umożliwia szybkie przetwarzanie wielostronicowych PDF‑ów. To zmniejsza potrzebę posiadania oddzielnych repozytoriów plików i utrzymuje powiązane dane razem. Uproszcza to także kontrolę wersji i zapewnia, że cała istotna dokumentacja podróżuje wraz ze skoroszytem, poprawiając współpracę w zespołach.

Wymagania wstępne

  • GroupDocs.Merger for .NET (najnowszy pakiet NuGet)
  • .NET Framework 4.5+ lub .NET Core/5+/6+
  • Visual Studio 2022 lub nowszy
  • Podstawowa znajomość C# oraz obcowanie z operacjami I/O na plikach

Konfigurowanie GroupDocs.Merger dla .NET

Instalacja

Dodaj pakiet, używając jednej z poniższych metod:

.NET CLI

dotnet add package GroupDocs.Merger

Package Manager

Install-Package GroupDocs.Merger

NuGet Package Manager UI
Wyszukaj „GroupDocs.Merger” i zainstaluj najnowszą wersję.

Uzyskiwanie licencji

  1. Free trial – przetestuj bibliotekę bez kosztów.
  2. Temporary license – zamów tymczasową licencję na temporary‑license page.
  3. Purchase – rozważ zakup licencji na GroupDocs purchase page.

Podstawowa inicjalizacja

Merger jest punktem wejścia dla wszystkich operacji.

using (Merger merger = new Merger("path_to_your_spreadsheet.xlsx"))
{
    // Your code to work with the document
}

Jak osadzić obiekty OLE w Excelu?

Wczytaj swój źródłowy skoroszyt, skonfiguruj opcje OLE i pozwól Merger wstawić obiekt. Poniższe sekcje dostarczają zwięzły, gotowy do uruchomienia przepływ pracy.

Przegląd funkcji

Osadzanie obiektów OLE pozwala przechowywać pełny PDF w komórce, zachowując pierwotny układ i umożliwiając dostęp jednym kliknięciem z Excela.

Implementacja krok po kroku

1. Ustaw ścieżki i numer strony

Określ arkusz kalkulacyjny, plik do osadzenia oraz adres docelowej komórki.

string filePath = "YOUR_DOCUMENT_DIRECTORY/SAMPLE_XLSX";
string embeddedFilePath = "YOUR_DOCUMENT_DIRECTORY/SAMPLE_PDF";
int pageNumber = 2; // The specific page to embed

// Output path for the modified spreadsheet
string filePathOut = Path.Combine("YOUR_OUTPUT_DIRECTORY", "OUT_SAMPLE_NAME.xlsx");

2. Skonfiguruj OleSpreadsheetOptions

OleSpreadsheetOptions defines where the OLE object will be placed in the worksheet and how its icon appears.

// Specify row and column indices for embedding
OleSpreadsheetOptions oleCellsOptions = new OleSpreadsheetOptions(embeddedFilePath, pageNumber)
{
    RowIndex = 2,
    ColumnIndex = 2
};

3. Zainicjalizuj Merger i wykonaj osadzanie

Klasa Merger obsługuje rzeczywiste wstawienie. Po wywołaniu skoroszyt zawiera ikonę OLE.

using (Merger merger = new Merger(filePath))
{
    merger.ImportDocument(oleCellsOptions); // Import the specified document as an OLE object into the spreadsheet
    merger.Save(filePathOut); // Save the modified document
}

Typowe wskazówki rozwiązywania problemów

  • Zweryfikuj, że wszystkie ścieżki plików są bezwzględne lub prawidłowo rozwiązywane względem pliku wykonywalnego.
  • Upewnij się, że podany numer strony istnieje w źródłowym PDF; w przeciwnym razie zostanie rzucony wyjątek.
  • Jeśli osadzony obiekt nie wyświetla się, potwierdź, że docelowa wersja Excela obsługuje OLE (większość nowoczesnych wersji tak).

Praktyczne zastosowania

Osadzanie PDF w Excelu jest przydatne dla:

  1. Raporty finansowe – dołącz audytowane sprawozdania bezpośrednio obok tabel podsumowujących.
  2. Dokumentacja projektowa – przechowuj specyfikacje projektowe, analizy ryzyka lub umowy w głównym trackerze.
  3. Panele szkoleniowe – osadź podręczniki użytkownika lub PDF‑y z politykami dla szybkiego odniesienia przez personel.

Rozważania dotyczące wydajności

  • Rozmiar pliku – utrzymuj osadzone PDF‑y poniżej 5 MB, aby uniknąć rozrostu skoroszytu.
  • Użycie pamięci – GroupDocs.Merger strumieniuje dane, więc zużycie pamięci pozostaje niskie nawet przy dużych plikach źródłowych.
  • Zwalnianie obiektów – zawsze wywołuj Dispose() na instancjach Merger, aby szybko zwolnić uchwyty plików.

Najczęściej zadawane pytania

P: Czym jest obiekt OLE?
O: Obiekt OLE (Object Linking and Embedding) przechowuje inny plik (PDF, Word, obraz itp.) w dokumencie nadrzędnym, umożliwiając edycję w miejscu lub otwarcie.

P: Czy mogę osadzać obiekty OLE w innych formatach Office?
O: Tak — GroupDocs.Merger obsługuje także pliki Word, PowerPoint i Visio.

P: Jak obsłużyć PDF‑y zabezpieczone hasłem?
O: Podaj hasło przy tworzeniu instancji OleSpreadsheetOptions; biblioteka automatycznie odszyfruje plik.

P: Czy istnieje ograniczenie rozmiaru dla osadzonych PDF‑ów?
O: Technicznie nie ma sztywnego limitu, ale pliki większe niż 10 MB mogą zauważalnie zwiększyć czas ładowania skoroszytu.

P: Gdzie mogę znaleźć więcej przykładów?
O: Odwiedź oficjalną GroupDocs Documentation po dodatkowe przykłady kodu i odniesienia API.

Dodatkowe zasoby

Ostatnia aktualizacja: 2026-09-21
Testowano z: GroupDocs.Merger 23.12 dla .NET
Autor: GroupDocs

Powiązane samouczki