Библиотека шарписта | C#, F#, .NET, ASP.NET: “🖨 Добавляем картинку в PDF Разбираемся, как встроить изображение в PD…”

🖨 Добавляем картинку в PDF

Разбираемся, как встроить изображение в PDF так, чтобы всё корректно печаталось, с помощью C#.

IronPdf — это библиотека, которая работает по принципу «что видите в HTML, то получите в PDF». Вместо возни с координатами вы просто верстаете страницу как для браузера.

Библиотека платная для коммерческих проектов, но есть пробный период. Для некоммерческих целей можно использовать бесплатно.

Самый простой способ — сгенерировать HTML с тегом <img> и конвертировать в PDF:

using IronPdf;

var renderer = new ChromePdfRenderer();

string html = @"
<html>
<body>
    <img src='logo.png' style='width: 200px;' />
    <p>Текст под картинкой</p>
</body>
</html>";

var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("document_with_image.pdf");

Если картинка приходит из базы данных или веб-формы, удобнее встроить её прямо в HTML через Data URI:

byte[] imageBytes = File.ReadAllBytes("logo.png");
string base64 = Convert.ToBase64String(imageBytes);

string html = $@"
<html>
<body>
    <img src='data:image/png;base64,{base64}' style='width: 200px;' />
    <h2>Отчёт за декабрь</h2>
</body>
</html>";

var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("report.pdf");

Если нужно добавить штамп или подпись на готовый документ, IronPdf позволяет работать со слоями:

var existingPdf = PdfDocument.FromFile("contract.pdf");

// Создаём HTML со штампом
string stampHtml = @"
<div style='position: absolute; bottom: 50px; right: 50px;'>
    <img src='approved_stamp.png' style='width: 100px; opacity: 0.7;' />
</div>";

var stampPdf = renderer.RenderHtmlAsPdf(stampHtml);

// Накладываем на каждую страницу
foreach (var page in existingPdf.Pages)
{
    page.AddBackgroundPdf(stampPdf);
}

existingPdf.SaveAs("contract_approved.pdf");

Частые ошибки

• Картинка не появляется — проверьте путь к файлу. IronPdf ищет относительно рабочей директории приложения. Используйте Path.GetFullPath() для отладки или встраивайте через Base64.

• Размытые изображения — убедитесь, что исходное разрешение картинки достаточное. Для печати нужно минимум 300 DPI. Если растягиваете маленькое изображение через width в CSS, оно будет мыльным.

• Огромный размер файла — IronPdf встраивает оригиналы. Оптимизируйте картинки заранее: сжимайте JPEG до 80-85% качества, для PNG используйте инструменты вроде TinyPNG.

📍 Навигация: Вакансии • Задачи • Собесы

🐸Библиотека шарписта

#sharp_view