Unimake.Wkhtmltopdf
20221005.1536.42
dotnet add package Unimake.Wkhtmltopdf --version 20221005.1536.42
NuGet\Install-Package Unimake.Wkhtmltopdf -Version 20221005.1536.42
<PackageReference Include="Unimake.Wkhtmltopdf" Version="20221005.1536.42" />
paket add Unimake.Wkhtmltopdf --version 20221005.1536.42
#r "nuget: Unimake.Wkhtmltopdf, 20221005.1536.42"
// Install Unimake.Wkhtmltopdf as a Cake Addin
#addin nuget:?package=Unimake.Wkhtmltopdf&version=20221005.1536.42
// Install Unimake.Wkhtmltopdf as a Cake Tool
#tool nuget:?package=Unimake.Wkhtmltopdf&version=20221005.1536.42
Unimake.Wkhtmltopdf
Este projeto implementa uma versão mais simplificada da biblioteca https://github.com/fpanaccia/Wkhtmltopdf.NetCore para converter html em pdf, apenas para windows.<br/> Obrigado fpanaccia por compartilhar a versão completa para .NET<br/> Utiliza o projeto https://wkhtmltopdf.org/ para a conversão.
Como utilizar
Instale o pacote https://www.nuget.org/packages/Unimake.Wkhtmltopdf
Os arquivos da biblioteca Wkhtmltopdf devem estar disponibilizados no seu projeto na seguinte estrutura
├── Example.sln
| ├── Example.csproj
| ├──── Wkhtmltox
| | ├── win-x64 <<-- Este diretório é obrigatório
| | | ├── wkhtmltopdf.exe
| | | └── wkhtmltox.dll
Para baixar as versões utilizadas na biblioteca, baixe em:<br/> wkhtmltopdf.exe <br/> wkhtmltox.dll
Para baixar versões mais atuais: https://wkhtmltopdf.org/downloads.html
Estes arquivos devem ser incluídos na sua solução e marcados como "Copy Always" para serem copiados para o diretório de build.<br/> Se publicados em um servidor web, os mesmos deverão ser enviados juntamente com o pacote de distribuição. <br/> O diretório "win-x64" é obrigatório
Esta estrutrura de arquivos, é a estrutrua padrão desta biblioteca, caso queira mudar, passe a configuração através das opções definidas em ConvertOptions.WkhtmltoxPath
Exemplo de código com biblioteca e diretórios alterados
var html = "<p>This is a paragraph.</p>";
var options = new ConvertOptions
{
WkhtmltoxPath = "libs\\MyLibFolder"
};
var bytes = new HtmlToPdfConverter(options).GetPDFAsByteArray(html);
Assert.NotNull(bytes);
Recuperando um array de bytes e salvando em um arquivo .pdf
[Fact]
public void GetPDFAsByteArray()
{
var html = "<p>This is a paragraph.</p>";
var bytes = new HtmlToPdfConverter().GetPDFAsByteArray(html);
Assert.NotNull(bytes);
var fi = new FileInfo("test.pdf");
if(fi.Exists)
{
fi.Delete();
}
File.WriteAllBytes(fi.FullName, bytes);
//Open pdf file
_ = Process.Start(new ProcessStartInfo
{
UseShellExecute = true,
FileName = fi.FullName
});
}
Recuperando uma string padrão Base64
[Fact]
public void GetPDFAsBase64()
{
var html = "<p>This is a paragraph.</p>";
var pdf = new HtmlToPdfConverter().GetPDFAsBase64(html);
Assert.NotNull(pdf);
//save to file
var bytes = Convert.FromBase64String(pdf);
Assert.NotNull(bytes);
var fi = new FileInfo("test.pdf");
if(fi.Exists)
{
fi.Delete();
}
File.WriteAllBytes(fi.FullName, bytes);
//Open pdf file
_ = Process.Start(new ProcessStartInfo
{
UseShellExecute = true,
FileName = fi.FullName
});
}
Veja outros exemplos de uso em Unimake.Wkhtmltopdf.Test
Product | Versions |
---|---|
.NET | net5.0 net5.0-windows net6.0 net6.0-android net6.0-ios net6.0-maccatalyst net6.0-macos net6.0-tvos net6.0-windows net7.0 net7.0-android net7.0-ios net7.0-maccatalyst net7.0-macos net7.0-tvos net7.0-windows |
.NET Core | netcoreapp2.0 netcoreapp2.1 netcoreapp2.2 netcoreapp3.0 netcoreapp3.1 |
.NET Standard | netstandard2.0 netstandard2.1 |
.NET Framework | net461 net462 net463 net47 net471 net472 net48 |
MonoAndroid | monoandroid |
MonoMac | monomac |
MonoTouch | monotouch |
Tizen | tizen40 tizen60 |
Xamarin.iOS | xamarinios |
Xamarin.Mac | xamarinmac |
Xamarin.TVOS | xamarintvos |
Xamarin.WatchOS | xamarinwatchos |
-
.NETStandard 2.0
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
20221005.1536.42 | 183 | 10/5/2022 |