Jak vložit PDF do Excelu pomocí GroupDocs.Merger pro .NET

Úvod

Vkládání PDF do Excelu vám umožní mít podpůrné dokumenty — jako smlouvy, zprávy nebo specifikace — přímo tam, kde jsou data. S GroupDocs.Merger pro .NET můžete přidávat OLE objekty do buněk během několika řádků kódu, čímž proměníte obyčejnou tabulku na interaktivní, samostatný sešit. Tento tutoriál vás provede vším, co potřebujete vědět, od instalace po řešení problémů.

Co se naučíte

  • Jak nastavit GroupDocs.Merger pro .NET v C# projektu
  • Přesné kroky pro vložení PDF (nebo jakéhokoli OLE‑kompatibilního souboru) do buňky v Excelu
  • Možnosti konfigurace, tipy na výkon a běžné úskalí

Než začneme, ověřme, že máte vše připravené.

Rychlé odpovědi

  • Mohu vložit jakýkoli typ souboru? Ano — jakýkoli formát podporovaný jako OLE objekt (PDF, Word, obrázek atd.).
  • Potřebuji licenci pro vývoj? Bezplatná zkušební verze stačí pro testování; pro produkci je vyžadována trvalá licence.
  • Které verze .NET jsou podporovány? .NET Framework 4.5+, .NET Core 3.1+, .NET 5/6/7+.
  • Zvětší se velikost souboru Excel výrazně? Pouze o velikost vloženého dokumentu; pro nejlepší výkon udržujte soubory pod několika MB.
  • Existuje limit na počet OLE objektů? Prakticky žádný, ale velmi velké sešity mohou ovlivnit dobu načítání.

Co je vložení PDF do Excelu?

Vkládání PDF do Excelu vloží celý PDF jako OLE objekt, který lze otevřít přímo z tabulky. Uživatelé kliknou na ikonu a zobrazí si původní dokument bez opuštění Excelu. Tento přístup zachovává původní rozvržení, umožňuje rychlé odkazy a eliminuje potřebu spravovat samostatné soubory. Vložené PDF se chová jako jakýkoli jiný OLE objekt, umožňující dvojklik na ikonu pro spuštění PDF prohlížeče přímo v prostředí Excelu.

Proč vkládat OLE objekty do Excelu?

GroupDocs.Merger podporuje 120+ vstupních a výstupních formátů a může vkládat objekty bez načítání celého souboru do paměti, což umožňuje rychlé zpracování stovek stránek PDF. Tím se snižuje potřeba samostatných úložišť souborů a udržují se související data pohromadě. Také to zjednodušuje správu verzí a zajišťuje, že veškerá relevantní dokumentace cestuje se sešitem, čímž se zlepšuje spolupráce napříč týmy.

Předpoklady

  • GroupDocs.Merger for .NET (nejnovější balíček NuGet)
  • .NET Framework 4.5+ or .NET Core/5+/6+
  • Visual Studio 2022 or later
  • Základní znalost C# a seznámení se se souborovým I/O

Nastavení GroupDocs.Merger pro .NET

Instalace

Add the package using one of the following methods:

.NET CLI

dotnet add package GroupDocs.Merger

Package Manager

Install-Package GroupDocs.Merger

NuGet Package Manager UI
Vyhledejte “GroupDocs.Merger” a nainstalujte nejnovější verzi.

Získání licence

  1. Bezplatná zkušební verze – testujte knihovnu zdarma.
  2. Dočasná licence – požádejte o dočasnou licenci na temporary‑license page.
  3. Nákup – zvažte zakoupení licence na GroupDocs purchase page.

Základní inicializace

Merger je vstupní bod pro všechny operace.

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

Jak vložit OLE objekty do Excelu?

Načtěte svůj zdrojový sešit, nakonfigurujte OLE možnosti a nechte Merger vložit objekt. Následující sekce vám poskytnou stručný, připravený k běhu workflow.

Přehled funkce

Vkládání OLE objektů vám umožní uložit kompletní PDF do buňky, zachovat původní rozvržení a umožnit jedním kliknutím přístup z Excelu.

Implementace krok za krokem

1. Nastavte cesty a číslo stránky

Zadejte tabulku, soubor k vložení a cílovou adresu buňky.

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. Nakonfigurujte OleSpreadsheetOptions

OleSpreadsheetOptions určuje, kde bude OLE objekt umístěn v listu a jak se zobrazí jeho ikona.

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

3. Inicializujte Merger a proveďte vložení

Třída Merger provádí skutečné vložení. Po volání se v sešitu objeví ikona 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
}

Běžné tipy pro řešení problémů

  • Ověřte, že všechny cesty k souborům jsou absolutní nebo správně relativní k spustitelnému souboru.
  • Ujistěte se, že zadané číslo stránky existuje ve zdrojovém PDF; jinak je vyvolána výjimka.
  • Pokud se vložený objekt nezobrazuje, ověřte, že cílová verze Excel podporuje OLE (většina moderních verzí ano).

Praktické aplikace

Vkládání PDF do Excelu je užitečné pro:

  1. Finanční zprávy – připojte auditované výkazy přímo vedle souhrnných tabulek.
  2. Projektová dokumentace – uchovávejte návrhové specifikace, analýzy rizik nebo smlouvy v hlavním sledovači.
  3. Školící dashboardy – vložte uživatelské příručky nebo politiky PDF pro rychlé odkazy zaměstnancům.

Úvahy o výkonu

  • Velikost souboru – udržujte vložená PDF pod 5 MB, aby nedošlo k nafouknutí sešitu.
  • Využití paměti – GroupDocs.Merger streamuje data, takže spotřeba paměti zůstává nízká i u velkých zdrojových souborů.
  • Uvolňování objektů – vždy zavolejte Dispose() na instancích Merger, aby se rychle uvolnily souborové handle.

Často kladené otázky

Otázka: Co je OLE objekt?
O: OLE (Object Linking and Embedding) objekt ukládá jiný soubor (PDF, Word, obrázek atd.) uvnitř hostitelského dokumentu, což umožňuje úpravy nebo otevření na místě.

Otázka: Mohu vkládat OLE objekty do jiných formátů Office?
O: Ano — GroupDocs.Merger také podporuje soubory Word, PowerPoint a Visio.

Otázka: Jak zacházet s PDF chráněnými heslem?
O: Zadejte heslo při vytváření instance OleSpreadsheetOptions; knihovna soubor automaticky dešifruje.

Otázka: Existuje omezení velikosti pro vložená PDF?
O: Technicky neexistuje pevný limit, ale soubory větší než 10 MB mohou výrazně prodloužit dobu načítání sešitu.

Otázka: Kde najdu více příkladů?
O: Navštivte oficiální GroupDocs Documentation pro další ukázky kódu a reference API.

Další zdroje

Last Updated: 2026-09-21
Tested with: GroupDocs.Merger 23.12 for .NET
Author: GroupDocs

Související tutoriály