├── .gitignore
├── IronPDF-Sample-Project.csproj
├── IronPDF-Sample-Project.sln
├── Program.cs
├── README.md
├── pdf_from_html.pdf
└── pdf_from_url.pdf
/.gitignore:
--------------------------------------------------------------------------------
1 | ## Ignore Visual Studio temporary files, build results, and
2 | ## files generated by popular Visual Studio add-ons.
3 | ##
4 | ## Get latest from https://github.com/github/gitignore/blob/main/VisualStudio.gitignore
5 |
6 | # User-specific files
7 | *.rsuser
8 | *.suo
9 | *.user
10 | *.userosscache
11 | *.sln.docstates
12 |
13 | # User-specific files (MonoDevelop/Xamarin Studio)
14 | *.userprefs
15 |
16 | # Mono auto generated files
17 | mono_crash.*
18 |
19 | # Build results
20 | [Dd]ebug/
21 | [Dd]ebugPublic/
22 | [Rr]elease/
23 | [Rr]eleases/
24 | x64/
25 | x86/
26 | [Ww][Ii][Nn]32/
27 | [Aa][Rr][Mm]/
28 | [Aa][Rr][Mm]64/
29 | bld/
30 | [Bb]in/
31 | [Oo]bj/
32 | [Ll]og/
33 | [Ll]ogs/
34 |
35 | # Visual Studio 2015/2017 cache/options directory
36 | .vs/
37 | # Uncomment if you have tasks that create the project's static files in wwwroot
38 | #wwwroot/
39 |
40 | # Visual Studio 2017 auto generated files
41 | Generated\ Files/
42 |
43 | # MSTest test Results
44 | [Tt]est[Rr]esult*/
45 | [Bb]uild[Ll]og.*
46 |
47 | # NUnit
48 | *.VisualState.xml
49 | TestResult.xml
50 | nunit-*.xml
51 |
52 | # Build Results of an ATL Project
53 | [Dd]ebugPS/
54 | [Rr]eleasePS/
55 | dlldata.c
56 |
57 | # Benchmark Results
58 | BenchmarkDotNet.Artifacts/
59 |
60 | # .NET Core
61 | project.lock.json
62 | project.fragment.lock.json
63 | artifacts/
64 |
65 | # ASP.NET Scaffolding
66 | ScaffoldingReadMe.txt
67 |
68 | # StyleCop
69 | StyleCopReport.xml
70 |
71 | # Files built by Visual Studio
72 | *_i.c
73 | *_p.c
74 | *_h.h
75 | *.ilk
76 | *.meta
77 | *.obj
78 | *.iobj
79 | *.pch
80 | *.pdb
81 | *.ipdb
82 | *.pgc
83 | *.pgd
84 | *.rsp
85 | *.sbr
86 | *.tlb
87 | *.tli
88 | *.tlh
89 | *.tmp
90 | *.tmp_proj
91 | *_wpftmp.csproj
92 | *.log
93 | *.tlog
94 | *.vspscc
95 | *.vssscc
96 | .builds
97 | *.pidb
98 | *.svclog
99 | *.scc
100 |
101 | # Chutzpah Test files
102 | _Chutzpah*
103 |
104 | # Visual C++ cache files
105 | ipch/
106 | *.aps
107 | *.ncb
108 | *.opendb
109 | *.opensdf
110 | *.sdf
111 | *.cachefile
112 | *.VC.db
113 | *.VC.VC.opendb
114 |
115 | # Visual Studio profiler
116 | *.psess
117 | *.vsp
118 | *.vspx
119 | *.sap
120 |
121 | # Visual Studio Trace Files
122 | *.e2e
123 |
124 | # TFS 2012 Local Workspace
125 | $tf/
126 |
127 | # Guidance Automation Toolkit
128 | *.gpState
129 |
130 | # ReSharper is a .NET coding add-in
131 | _ReSharper*/
132 | *.[Rr]e[Ss]harper
133 | *.DotSettings.user
134 |
135 | # TeamCity is a build add-in
136 | _TeamCity*
137 |
138 | # DotCover is a Code Coverage Tool
139 | *.dotCover
140 |
141 | # AxoCover is a Code Coverage Tool
142 | .axoCover/*
143 | !.axoCover/settings.json
144 |
145 | # Coverlet is a free, cross platform Code Coverage Tool
146 | coverage*.json
147 | coverage*.xml
148 | coverage*.info
149 |
150 | # Visual Studio code coverage results
151 | *.coverage
152 | *.coveragexml
153 |
154 | # NCrunch
155 | _NCrunch_*
156 | .*crunch*.local.xml
157 | nCrunchTemp_*
158 |
159 | # MightyMoose
160 | *.mm.*
161 | AutoTest.Net/
162 |
163 | # Web workbench (sass)
164 | .sass-cache/
165 |
166 | # Installshield output folder
167 | [Ee]xpress/
168 |
169 | # DocProject is a documentation generator add-in
170 | DocProject/buildhelp/
171 | DocProject/Help/*.HxT
172 | DocProject/Help/*.HxC
173 | DocProject/Help/*.hhc
174 | DocProject/Help/*.hhk
175 | DocProject/Help/*.hhp
176 | DocProject/Help/Html2
177 | DocProject/Help/html
178 |
179 | # Click-Once directory
180 | publish/
181 |
182 | # Publish Web Output
183 | *.[Pp]ublish.xml
184 | *.azurePubxml
185 | # Note: Comment the next line if you want to checkin your web deploy settings,
186 | # but database connection strings (with potential passwords) will be unencrypted
187 | *.pubxml
188 | *.publishproj
189 |
190 | # Microsoft Azure Web App publish settings. Comment the next line if you want to
191 | # checkin your Azure Web App publish settings, but sensitive information contained
192 | # in these scripts will be unencrypted
193 | PublishScripts/
194 |
195 | # NuGet Packages
196 | *.nupkg
197 | # NuGet Symbol Packages
198 | *.snupkg
199 | # The packages folder can be ignored because of Package Restore
200 | **/[Pp]ackages/*
201 | # except build/, which is used as an MSBuild target.
202 | !**/[Pp]ackages/build/
203 | # Uncomment if necessary however generally it will be regenerated when needed
204 | #!**/[Pp]ackages/repositories.config
205 | # NuGet v3's project.json files produces more ignorable files
206 | *.nuget.props
207 | *.nuget.targets
208 |
209 | # Microsoft Azure Build Output
210 | csx/
211 | *.build.csdef
212 |
213 | # Microsoft Azure Emulator
214 | ecf/
215 | rcf/
216 |
217 | # Windows Store app package directories and files
218 | AppPackages/
219 | BundleArtifacts/
220 | Package.StoreAssociation.xml
221 | _pkginfo.txt
222 | *.appx
223 | *.appxbundle
224 | *.appxupload
225 |
226 | # Visual Studio cache files
227 | # files ending in .cache can be ignored
228 | *.[Cc]ache
229 | # but keep track of directories ending in .cache
230 | !?*.[Cc]ache/
231 |
232 | # Others
233 | ClientBin/
234 | ~$*
235 | *~
236 | *.dbmdl
237 | *.dbproj.schemaview
238 | *.jfm
239 | *.pfx
240 | *.publishsettings
241 | orleans.codegen.cs
242 |
243 | # Including strong name files can present a security risk
244 | # (https://github.com/github/gitignore/pull/2483#issue-259490424)
245 | #*.snk
246 |
247 | # Since there are multiple workflows, uncomment next line to ignore bower_components
248 | # (https://github.com/github/gitignore/pull/1529#issuecomment-104372622)
249 | #bower_components/
250 |
251 | # RIA/Silverlight projects
252 | Generated_Code/
253 |
254 | # Backup & report files from converting an old project file
255 | # to a newer Visual Studio version. Backup files are not needed,
256 | # because we have git ;-)
257 | _UpgradeReport_Files/
258 | Backup*/
259 | UpgradeLog*.XML
260 | UpgradeLog*.htm
261 | ServiceFabricBackup/
262 | *.rptproj.bak
263 |
264 | # SQL Server files
265 | *.mdf
266 | *.ldf
267 | *.ndf
268 |
269 | # Business Intelligence projects
270 | *.rdl.data
271 | *.bim.layout
272 | *.bim_*.settings
273 | *.rptproj.rsuser
274 | *- [Bb]ackup.rdl
275 | *- [Bb]ackup ([0-9]).rdl
276 | *- [Bb]ackup ([0-9][0-9]).rdl
277 |
278 | # Microsoft Fakes
279 | FakesAssemblies/
280 |
281 | # GhostDoc plugin setting file
282 | *.GhostDoc.xml
283 |
284 | # Node.js Tools for Visual Studio
285 | .ntvs_analysis.dat
286 | node_modules/
287 |
288 | # Visual Studio 6 build log
289 | *.plg
290 |
291 | # Visual Studio 6 workspace options file
292 | *.opt
293 |
294 | # Visual Studio 6 auto-generated workspace file (contains which files were open etc.)
295 | *.vbw
296 |
297 | # Visual Studio 6 auto-generated project file (contains which files were open etc.)
298 | *.vbp
299 |
300 | # Visual Studio 6 workspace and project file (working project files containing files to include in project)
301 | *.dsw
302 | *.dsp
303 |
304 | # Visual Studio 6 technical files
305 | *.ncb
306 | *.aps
307 |
308 | # Visual Studio LightSwitch build output
309 | **/*.HTMLClient/GeneratedArtifacts
310 | **/*.DesktopClient/GeneratedArtifacts
311 | **/*.DesktopClient/ModelManifest.xml
312 | **/*.Server/GeneratedArtifacts
313 | **/*.Server/ModelManifest.xml
314 | _Pvt_Extensions
315 |
316 | # Paket dependency manager
317 | .paket/paket.exe
318 | paket-files/
319 |
320 | # FAKE - F# Make
321 | .fake/
322 |
323 | # CodeRush personal settings
324 | .cr/personal
325 |
326 | # Python Tools for Visual Studio (PTVS)
327 | __pycache__/
328 | *.pyc
329 |
330 | # Cake - Uncomment if you are using it
331 | # tools/**
332 | # !tools/packages.config
333 |
334 | # Tabs Studio
335 | *.tss
336 |
337 | # Telerik's JustMock configuration file
338 | *.jmconfig
339 |
340 | # BizTalk build output
341 | *.btp.cs
342 | *.btm.cs
343 | *.odx.cs
344 | *.xsd.cs
345 |
346 | # OpenCover UI analysis results
347 | OpenCover/
348 |
349 | # Azure Stream Analytics local run output
350 | ASALocalRun/
351 |
352 | # MSBuild Binary and Structured Log
353 | *.binlog
354 |
355 | # NVidia Nsight GPU debugger configuration file
356 | *.nvuser
357 |
358 | # MFractors (Xamarin productivity tool) working folder
359 | .mfractor/
360 |
361 | # Local History for Visual Studio
362 | .localhistory/
363 |
364 | # Visual Studio History (VSHistory) files
365 | .vshistory/
366 |
367 | # BeatPulse healthcheck temp database
368 | healthchecksdb
369 |
370 | # Backup folder for Package Reference Convert tool in Visual Studio 2017
371 | MigrationBackup/
372 |
373 | # Ionide (cross platform F# VS Code tools) working folder
374 | .ionide/
375 |
376 | # Fody - auto-generated XML schema
377 | FodyWeavers.xsd
378 |
379 | # VS Code files for those working on multiple tools
380 | .vscode/*
381 | !.vscode/settings.json
382 | !.vscode/tasks.json
383 | !.vscode/launch.json
384 | !.vscode/extensions.json
385 | *.code-workspace
386 |
387 | # Local History for Visual Studio Code
388 | .history/
389 |
390 | # Windows Installer files from build outputs
391 | *.cab
392 | *.msi
393 | *.msix
394 | *.msm
395 | *.msp
396 |
397 | # JetBrains Rider
398 | *.sln.iml
399 |
--------------------------------------------------------------------------------
/IronPDF-Sample-Project.csproj:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 | Exe
5 | net5.0
6 | IronPDF_Sample_Project
7 |
8 |
9 |
10 |
11 |
12 |
13 |
14 |
--------------------------------------------------------------------------------
/IronPDF-Sample-Project.sln:
--------------------------------------------------------------------------------
1 |
2 | Microsoft Visual Studio Solution File, Format Version 12.00
3 | Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "IronPDF-Sample-Project", "IronPDF-Sample-Project.csproj", "{D1E21083-795A-40C4-B9FC-73E505BB0345}"
4 | EndProject
5 | Global
6 | GlobalSection(SolutionConfigurationPlatforms) = preSolution
7 | Debug|Any CPU = Debug|Any CPU
8 | Release|Any CPU = Release|Any CPU
9 | EndGlobalSection
10 | GlobalSection(ProjectConfigurationPlatforms) = postSolution
11 | {D1E21083-795A-40C4-B9FC-73E505BB0345}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
12 | {D1E21083-795A-40C4-B9FC-73E505BB0345}.Debug|Any CPU.Build.0 = Debug|Any CPU
13 | {D1E21083-795A-40C4-B9FC-73E505BB0345}.Release|Any CPU.ActiveCfg = Release|Any CPU
14 | {D1E21083-795A-40C4-B9FC-73E505BB0345}.Release|Any CPU.Build.0 = Release|Any CPU
15 | EndGlobalSection
16 | EndGlobal
17 |
--------------------------------------------------------------------------------
/Program.cs:
--------------------------------------------------------------------------------
1 | using System;
2 | using IronPdf;
3 | using IronPdf.Engines.Chrome;
4 | using IronPdf.Rendering;
5 |
6 | namespace IronPDF_Sample_Project
7 | {
8 | class Program
9 | {
10 | // Example of HTML string to be rendered into a PDF
11 | private const string SampleHtmlString = "Hello World!
This is IronPdf.
";
12 |
13 | static void Main(string[] args)
14 | {
15 | // Get a free license key instantly: https://ironpdf.com/#trial-license
16 | IronPdf.License.LicenseKey = "ENTER-KEY-HERE";
17 |
18 | Console.WriteLine("Welcome to the IronPDF `Hello World' Tutorial!");
19 |
20 | // Example of an HTML String to PDF
21 | HtmlToPdfExample(SampleHtmlString);
22 |
23 | // Example of URL to PDF
24 | UrlToPdfExample("https://getbootstrap.com/");
25 |
26 | Console.WriteLine("IronPDF Tutorial Complete! Press any key to exit!");
27 | Console.ReadKey();
28 | }
29 |
30 | public static void HtmlToPdfExample(string htmlString)
31 | {
32 | // Start by initializing the Chrome Renderer
33 | ChromePdfRenderer renderer = new ChromePdfRenderer();
34 |
35 | // Render a new PdfDocument using an HTML string
36 | PdfDocument newPdf = renderer.RenderHtmlAsPdf(htmlString);
37 |
38 | // Save new PDF File
39 | newPdf.SaveAs("pdf_from_html.pdf");
40 | }
41 |
42 | public static void UrlToPdfExample(string url)
43 | {
44 | // Start by initializing the Chrome Renderer
45 | ChromePdfRenderer renderer = new ChromePdfRenderer();
46 |
47 | // Set Pdf CssMediaType to Screen to get all the background
48 | renderer.RenderingOptions = new ChromePdfRenderOptions()
49 | {
50 | // Screen vs Print: https://ironpdf.com/tutorials/pixel-perfect-html-to-pdf/#decide-to-use-css-media-type-print-or-screen
51 | CssMediaType = PdfCssMediaType.Screen,
52 | PrintHtmlBackgrounds = true,
53 |
54 | // Set Margins
55 | MarginTop = 10,
56 | MarginBottom = 10,
57 | MarginLeft = 10,
58 | MarginRight = 10
59 | };
60 |
61 | // Render a new PdfDocument from a URL
62 | PdfDocument newPdf = renderer.RenderUrlAsPdf(url);
63 |
64 | // Save new PDF File
65 | newPdf.SaveAs("pdf_from_url.pdf");
66 | }
67 | }
68 | }
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 | # IronPDF "Hello World" Example in C#
2 |
3 | ## IronPDF Features and Compatiblity
4 |
5 | IronPDF easily handles all these features:
6 | - Generating PDFs from: HTML, URL, JavaScript, CSS and many image formats
7 | - Adding headers/footers, signatures, attachments, compression, and passwords and security
8 | - Performance optimization: Full Multihreading and Async support
9 | - And many more! Visit our website to see all our code examples and a full list of our 50+ features
10 |
11 | IronPDF also has cross platform support compatibility with:
12 | - .NET 7 and .NET 6, .NET Core, Standard, and Framework (4.6.2+)
13 | - Windows, macOS, Linux, Docker, Azure, and AWS
14 |
15 | ## Code Example
16 |
17 | ```csharp
18 | using IronPdf;
19 | using IronPdf.Engines.Chrome;
20 | using IronPdf.Rendering;
21 |
22 | // Example of HTML string to be rendered into a PDF
23 | private const string SampleHtmlString = "Hello World!
This is IronPdf.
";
24 |
25 | static void Main(string[] args)
26 | {
27 | // Get a free license key instantly: https://ironpdf.com/#trial-license
28 | IronPdf.License.LicenseKey = "ENTER-KEY-HERE";
29 |
30 | Console.WriteLine("Welcome to the IronPDF `Hello World' Tutorial!");
31 |
32 | // Example of an HTML String to PDF
33 | HtmlToPdfExample(SampleHtmlString);
34 |
35 | // Example of URL to PDF
36 | UrlToPdfExample("https://getbootstrap.com/");
37 |
38 | Console.WriteLine("IronPDF Tutorial Complete! Press any key to exit!");
39 | Console.ReadKey();
40 | }
41 |
42 | public static void HtmlToPdfExample(string htmlString)
43 | {
44 | // Start by initializing the Chrome Renderer
45 | ChromePdfRenderer renderer = new ChromePdfRenderer();
46 |
47 | // Render a new PdfDocument using an HTML string
48 | PdfDocument newPdf = renderer.RenderHtmlAsPdf(SampleHtmlString);
49 |
50 | // Save new PDF File
51 | newPdf.SaveAs("pdf_from_html.pdf");
52 | }
53 |
54 | public static void UrlToPdfExample(string url)
55 | {
56 | // Start by initializing the Chrome Renderer
57 | ChromePdfRenderer renderer = new ChromePdfRenderer();
58 |
59 | // Set Pdf CssMediaType to Screen to get all the background
60 | renderer.RenderingOptions = new ChromePdfRenderOptions()
61 | {
62 | // Screen vs Print: https://ironpdf.com/how-to/pixel-perfect-html-to-pdf/#1-decide-to-use-css-media-type-print-or-screen
63 | CssMediaType = PdfCssMediaType.Screen,
64 | PrintHtmlBackgrounds = true,
65 |
66 | // Set Margins
67 | MarginTop = 10,
68 | MarginBottom = 10,
69 | MarginLeft = 10,
70 | MarginRight = 10
71 | };
72 |
73 | // Render a new PdfDocument from a URL
74 | PdfDocument newPdf = renderer.RenderUrlAsPdf(url);
75 |
76 | // Save new PDF File
77 | newPdf.SaveAs("pdf_from_url.pdf");
78 | }
79 | ```
80 |
81 | Get Started creating PDF documents with IronPDF in C# now! https://github.com/iron-software
82 |
--------------------------------------------------------------------------------
/pdf_from_html.pdf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/iron-software/iron-pdf-example-hello-world-csharp/66b97862a2597d006cc9cf9925a9a682d0f537c5/pdf_from_html.pdf
--------------------------------------------------------------------------------
/pdf_from_url.pdf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/iron-software/iron-pdf-example-hello-world-csharp/66b97862a2597d006cc9cf9925a9a682d0f537c5/pdf_from_url.pdf
--------------------------------------------------------------------------------