Initial commit - blog samples added.

Author: chinnumuniyappan

README.md

@@ -1,2 +1,43 @@
-# import-export-pdf-annotations-csharp
-This repository provides C# examples using the Syncfusion .NET PDF Library to import and export annotations in PDF documents seamlessly. Explore five practical techniques to efficiently manage annotation data and enhance document workflows in your .NET applications
+# 5 Easy Ways to Import and Export PDF Annotations in C#
+
+The Syncfusion® .NET PDF Library provides powerful APIs to manage annotations in PDF documents. This collection of samples demonstrates five easy and effective ways to import and export annotations using different formats and customization options, helping developers streamline annotation workflows in their .NET applications.
+
+Sample name | Description
+------|------
+[Export and import annotations using XFDF format](https://github.com/SyncfusionExamples/import-export-pdf-annotations-csharp/tree/master/export-and-import-annotations-using-xfdf) | Demonstrates how to export annotations from a PDF document to XFDF format and import them back, ensuring a seamless round-trip annotation workflow.
+[Export and import annotations using FDF format](https://github.com/SyncfusionExamples/import-export-pdf-annotations-csharp/tree/master/export-and-import-annotations-to-fdf) | Shows how to use the FDF format to export and import annotations, offering a compact and structured way to manage annotation data.
+[Export and import annotations using JSON format](https://github.com/SyncfusionExamples/import-export-pdf-annotations-csharp/tree/master/export-and-import-annotations-json) | Explains how to serialize and deserialize PDF annotations using JSON, making it easy to integrate with web services and modern data workflows.
+[Export specific types of annotations](https://github.com/SyncfusionExamples/import-export-pdf-annotations-csharp/tree/master/export-specific-type-of-annotations) | Illustrates how to selectively export only certain types of annotations (e.g., highlights, text notes), allowing for targeted annotation management.
+[Export annotation with appearance](https://github.com/SyncfusionExamples/import-export-pdf-annotations-csharp/tree/master/export-annotations-with-appearance) | Demonstrates how to export annotations along with their visual appearance, ensuring consistent rendering across different platforms and viewers.
+
+## How to run the examples
+
+* Download this project to a location in your disk.
+* Open the solution file using Visual Studio.
+* Rebuild the solution to install the required NuGet package.
+* Run the application.
+
+## Resources
+
+* **Product page:** [Syncfusion® PDF Framework](https://www.syncfusion.com/document-processing/pdf-framework/net)
+* **Documentation page:** [Syncfusion® .NET PDF library](https://help.syncfusion.com/document-processing/pdf/pdf-library/net/overview)
+* **Online demo:** [Syncfusion® .NET PDF library - Online demos](https://ej2.syncfusion.com/aspnetcore/pdf/default#/fluent2)
+* **Blog:** [Syncfusion® .NET PDF library - Blog](https://www.syncfusion.com/blogs/category/pdf)
+* **Knowledge Base:** [Syncfusion® .NET PDF library - Knowledge Base](https://www.syncfusion.com/kb/windowsforms/pdf)
+* **EBooks:** [Syncfusion® .NET PDF library - EBooks](https://www.syncfusion.com/succinctly-free-ebooks)
+* **FAQ:** [Syncfusion® .NET PDF library - FAQ](https://www.syncfusion.com/faq/)
+
+## Support and feedback
+
+* For any other queries, reach our [Syncfusion® support team](https://www.syncfusion.com/support/directtrac/incidents/newincident?utm_source=github&utm_medium=listing&utm_campaign=github-docio-examples) or post the queries through the [community forums](https://www.syncfusion.com/forums?utm_source=github&utm_medium=listing&utm_campaign=github-docio-examples).
+* Request new feature through [Syncfusion® feedback portal](https://www.syncfusion.com/feedback?utm_source=github&utm_medium=listing&utm_campaign=github-docio-examples).
+
+## License
+
+This is a commercial product and requires a paid license for possession or use. Syncfusion’s licensed software, including this component, is subject to the terms and conditions of [Syncfusion's EULA](https://www.syncfusion.com/eula/es/?utm_source=github&utm_medium=listing&utm_campaign=github-docio-examples). You can purchase a licnense [here](https://www.syncfusion.com/sales/products?utm_source=github&utm_medium=listing&utm_campaign=github-docio-examples) or start a free 30-day trial [here](https://www.syncfusion.com/account/manage-trials/start-trials?utm_source=github&utm_medium=listing&utm_campaign=github-docio-examples).
+
+## About Syncfusion®
+
+Founded in 2001 and headquartered in Research Triangle Park, N.C., Syncfusion® has more than 26,000+ customers and more than 1 million users, including large financial institutions, Fortune 500 companies, and global IT consultancies.
+
+Today, we provide 1600+ components and frameworks for web ([Blazor](https://www.syncfusion.com/blazor-components?utm_source=github&utm_medium=listing&utm_campaign=github-docio-examples), [ASP.NET Core](https://www.syncfusion.com/aspnet-core-ui-controls?utm_source=github&utm_medium=listing&utm_campaign=github-docio-examples), [ASP.NET MVC](https://www.syncfusion.com/aspnet-mvc-ui-controls?utm_source=github&utm_medium=listing&utm_campaign=github-docio-examples), [ASP.NET WebForms](https://www.syncfusion.com/jquery/aspnet-webforms-ui-controls?utm_source=github&utm_medium=listing&utm_campaign=github-docio-examples), [JavaScript](https://www.syncfusion.com/javascript-ui-controls?utm_source=github&utm_medium=listing&utm_campaign=github-docio-examples), [Angular](https://www.syncfusion.com/angular-ui-components?utm_source=github&utm_medium=listing&utm_campaign=github-docio-examples), [React](https://www.syncfusion.com/react-ui-components?utm_source=github&utm_medium=listing&utm_campaign=github-docio-examples), [Vue](https://www.syncfusion.com/vue-ui-components?utm_source=github&utm_medium=listing&utm_campaign=github-docio-examples), and [Flutter](https://www.syncfusion.com/flutter-widgets?utm_source=github&utm_medium=listing&utm_campaign=github-docio-examples)), mobile ([Xamarin](https://www.syncfusion.com/xamarin-ui-controls?utm_source=github&utm_medium=listing&utm_campaign=github-docio-examples), [Flutter](https://www.syncfusion.com/flutter-widgets?utm_source=github&utm_medium=listing&utm_campaign=github-docio-examples), [UWP](https://www.syncfusion.com/uwp-ui-controls?utm_source=github&utm_medium=listing&utm_campaign=github-docio-examples), and [JavaScript](https://www.syncfusion.com/javascript-ui-controls?utm_source=github&utm_medium=listing&utm_campaign=github-docio-examples)), and desktop development ([WinForms](https://www.syncfusion.com/winforms-ui-controls?utm_source=github&utm_medium=listing&utm_campaign=github-docio-examples), [WPF](https://www.syncfusion.com/wpf-ui-controls?utm_source=github&utm_medium=listing&utm_campaign=github-docio-examples), [WinUI(Preview)](https://www.syncfusion.com/winui-controls?utm_source=github&utm_medium=listing&utm_campaign=github-docio-examples), [Flutter](https://www.syncfusion.com/flutter-widgets?utm_source=github&utm_medium=listing&utm_campaign=github-docio-examples) and [UWP](https://www.syncfusion.com/uwp-ui-controls?utm_source=github&utm_medium=listing&utm_campaign=github-docio-examples)). We provide ready-to-deploy enterprise software for dashboards, reports, data integration, and big data processing. Many customers have saved millions in licensing fees by deploying our software.

data/Annotation.pdf

@@ -0,0 +1,33 @@
+%FDF-1.2
+2 0 obj
+<</Type/Annot/Contents(Introduction)/BS<</W 2/S/S>>/C[.00 .00 1.00]/T(John Milton)/Subtype/Line/Rect[52.00 702.00 195.00 718.00]/LE[/None/None]/L[60.00 710.00 187.00 710.00]/IT/LineDimension/LLE 0/LL 0/CP/Inline/Cap false/Page 0>>
+endobj
+3 0 obj
+<</Type/Annot/Rect[475.00 27.00 549.00 71.00]/Contents(Page Number)/BS<</W 2/S/S>>/C[1.00 .00 .00]/T(John Milton)/Subtype/Circle/Page 0>>
+endobj
+4 0 obj
+<</Type/Annot/Rect[57.00 493.00 565.00 592.00]/Contents(Usage)/BS<</W 2/S/S>>/C[1.00 .6666667 .00]/T(John Milton)/Subtype/Square/AP 5 0 R/Page 0>>
+endobj
+5 0 obj
+<</N 6 0 R>>
+endobj
+6 0 obj
+<</BBox[.00 .00 508.00 99.00]/Type/XObject/Subtype/Form/Matrix[1.00 .00 .00 1.00 .00 .00]/Resources<</ProcSet[/PDF]>>/Filter/FlateDecode/Length 130>>stream
+x^]�1�0���?��6�dm��cš�O[��4A�ߛ��;���6��n�	�Sn�ǹ��A&��\C�3c*�������F+mS�>�E�Η�왶x3i�����\)�&U��N�Pf�E�����&�
+endstream
+endobj
+7 0 obj
+<</Type/Annot/Contents(Chapter 1 Conceptual Overview)/BS<</W 2/S/S>>/C[1.00 .00 .00]/T(John Milton)/Subtype/Polygon/Rect[81.00 308.00 534.00 358.00]/Vertices[129.00 356.00 486.00 356.00 532.00 333.00 486.00 310.00 129.00 310.00 83.00 333.00 129.00 356.00]/Page 0>>
+endobj
+8 0 obj
+<</Type/Annot/Rect[60.00 632.00 555.00 677.00]/Contents(Introduction)/C[1.00 1.00 .00]/T(John Milton)/Subtype/Highlight/QuadPoints[251.00 677.00 555.00 677.00 251.00 662.00 555.00 662.00 60.00 662.00 555.00 662.00 60.00 647.00 555.00 647.00 60.00 647.00 160.00 647.00 60.00 632.00 160.00 632.00]/Page 0>>
+endobj
+9 0 obj
+<</Type/Annot/Rect[225.00 451.00 245.00 471.00]/Contents(PDF Standard)/C[1.00 1.00 .00]/T(John Milton)/Open true/Subtype/Text/Name/Comment/Page 0>>
+endobj
+1 0 obj
+<</FDF<</Annots[2 0 R 3 0 R 4 0 R 7 0 R 8 0 R 9 0 R]/F()/UF()>>/Type/Catalog>>
+endobj
+trailer
+<</Root 1 0 R>>
+%%EOF

data/annotations.pdf

@@ -0,0 +1 @@
+{"pdfAnnotation":{ "0":{ "shapeAnnotation":[{"type":"Line","page":"0","start":"60,710","end":"187,710","contents":"Introduction","width":"2","style":"solid","color":"#0000FF","title":"John Milton","rect":{"x":"52","y":"702","width":"195","height":"718"},"head":"None","tail":"None","IT":"LineDimension","leaderExtend":"0","leaderLength":"0","caption-style":"Inline","caption":"false"},{"type":"Circle","page":"0","rect":{"x":"475","y":"27","width":"549","height":"71"},"contents":"Page Number","width":"2","style":"solid","color":"#FF0000","title":"John Milton"},{"type":"Square","page":"0","rect":{"x":"57","y":"493","width":"565","height":"592"},"contents":"Usage","width":"2","style":"solid","color":"#FFAA00","title":"John Milton","appearance":"eyJhcCI6eyJOIjp7InN0cmVhbSI6eyJCQm94Ijp7ImFycmF5IjpbeyJpbnQiOiIwIn0seyJpbnQiOiIwIn0seyJpbnQiOiI1MDgifSx7ImludCI6Ijk5In1dfSwiVHlwZSI6eyJuYW1lIjoiWE9iamVjdCJ9LCJTdWJ0eXBlIjp7Im5hbWUiOiJGb3JtIn0sIk1hdHJpeCI6eyJhcnJheSI6W3siaW50IjoiMSJ9LHsiaW50IjoiMCJ9LHsiaW50IjoiMCJ9LHsiaW50IjoiMSJ9LHsiaW50IjoiMCJ9LHsiaW50IjoiMCJ9XX0sIlJlc291cmNlcyI6eyJkaWN0Ijp7IlByb2NTZXQiOnsiYXJyYXkiOlt7Im5hbWUiOiJQREYifV19fX0sIkZpbHRlciI6eyJuYW1lIjoiRmxhdGVEZWNvZGUifSwiTGVuZ3RoIjp7ImludCI6IjEzMCJ9LCJkYXRhIjp7Im1vZGUiOiJyYXciLCJlbmNvZGluZyI6ImhleCIsImJ5dGVzIjoiMjUyMDQzNjg2MTZFNjc2NTIwNjM2RjJENkY3MjY0Njk2RTYxNzQ2NTIwNzM3OTczNzQ2NTZEMjA3NDZGMjA2QzY1NjY3NDJGNzQ2RjcwMkUwRDBBMzEyMDMwMjAzMDIwMzEyMDMwMjAzOTM5MjA2MzZEMEQwQTJGNDQ2NTc2Njk2MzY1NTI0NzQyMjA0MzUzMEQwQTJGNDQ2NTc2Njk2MzY1NTI0NzQyMjA2MzczMEQwQTVCNUQyMDMwMjA2NDBEMEEzMjIwNzcwRDBBMzAyMDZBMEQwQTMwMjA0QTBEMEEzMTIwMzAyRTM2MzYzNjM2MzYzNjM2MzYzNjM2MzYzNjM2MzYzNjM2MjAzMDIwNTI0NzBEMEEzMTIwMkQzMTIwMzUzMDM2MjAyRDM5MzcyMDcyNjUwRDBBNTMwRDBBIn19fX19"},{"type":"Polygon","page":"0","contents":"Chapter 1 Conceptual Overview","width":"2","style":"solid","color":"#FF0000","title":"John Milton","rect":{"x":"81","y":"308","width":"534","height":"358"},"vertices":"129,356;486,356;532,333;486,310;129,310;83,333;129,356"},{"type":"Highlight","page":"0","rect":{"x":"60","y":"632","width":"555","height":"677"},"contents":"Introduction","color":"#FFFF00","title":"John Milton","coords":"251,677,555,677,251,662,555,662,60,662,555,662,60,647,555,647,60,647,160,647,60,632,160,632"},{"type":"Text","page":"0","rect":{"x":"225","y":"451","width":"245","height":"471"},"contents":"PDF Standard","color":"#FFFF00","title":"John Milton","Open":"true","icon":"Comment"}]}}}

data/export-annotation.fdf

@@ -0,0 +1,25 @@
+<?xml version="1.0" encoding="utf-8"?>
+<xfdf xml:space="preserve" xmlns="http://ns.adobe.com/xfdf/">
+  <annots>
+    <line page="0" start="60,710" end="187,710" width="2" style="solid" color="#0000FF" title="John Milton" rect="52,702,195,718" head="None" tail="None" IT="LineDimension" leaderExtend="0" leaderLength="0" caption-style="Inline" caption="no">
+      <contents>Introduction</contents>
+    </line>
+    <circle page="0" rect="475,27,549,71" width="2" style="solid" color="#FF0000" title="John Milton">
+      <contents>Page Number</contents>
+    </circle>
+    <square page="0" rect="57,493,565,592" width="2" style="solid" color="#FFAA00" title="John Milton">
+      <contents>Usage</contents>
+    </square>
+    <polygon page="0" width="2" style="solid" color="#FF0000" title="John Milton" rect="81,308,534,358">
+      <vertices>129,356;486,356;532,333;486,310;129,310;83,333;129,356</vertices>
+      <contents>Chapter 1 Conceptual Overview</contents>
+    </polygon>
+    <highlight page="0" rect="60,632,555,677" color="#FFFF00" title="John Milton" coords="251,677,555,677,251,662,555,662,60,662,555,662,60,647,555,647,60,647,160,647,60,632,160,632">
+      <contents>Introduction</contents>
+    </highlight>
+    <text page="0" rect="225,451,245,471" color="#FFFF00" title="John Milton" open="yes" icon="Comment">
+      <contents>PDF Standard</contents>
+    </text>
+  </annots>
+  <f href="" />
+</xfdf>

data/export-annotation.json

@@ -0,0 +1,32 @@
+using Syncfusion.Pdf.Parsing;
+
+//Register your Syncfusion License Key
+Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense("Your License Key");
+
+//Export annotations to JSON format
+ExportAnnotationsToJson();
+
+//Import annotations from JSON format
+ImportAnnotationsFromJson();
+
+static void ExportAnnotationsToJson()
+{
+    //Load the PDF document
+    using (PdfLoadedDocument document = new PdfLoadedDocument("../../../../data/input-with-annotations.pdf"))
+    {
+        //Export the annotations to JSON format
+        document.ExportAnnotations("export-annotation.json", AnnotationDataFormat.Json);
+    }
+}
+static void ImportAnnotationsFromJson()
+{
+    //Load the PDF document
+    using (PdfLoadedDocument document = new PdfLoadedDocument("../../../../data/input-empty.pdf"))
+    {
+        //Import the annotations from JSON format
+        document.ImportAnnotations("../../../../data/export-annotation.json", AnnotationDataFormat.Json);
+
+        //Save the modified document
+        document.Save("imported-annotations.pdf");
+    }
+}

data/export-annotation.xfdf

@@ -0,0 +1,15 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net8.0</TargetFramework>
+    <RootNamespace>export_and_import_annotations_json</RootNamespace>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Syncfusion.Pdf.Net.Core" Version="*" />
+  </ItemGroup>
+
+</Project>