Added Web API Page in DocIO

Author: Karan-SF4772

Document-Processing/Word/Conversions/Word-To-Image/NET/ASP-NET-Core-WEB-API-images/ASP-NET-Core-Web-API-template.png

@@ -0,0 +1,173 @@
+---
+title: Convert Word to Image in ASP.NET Core Web API | Syncfusion
+description: Convert Word to image in ASP.NET Core Web API using .NET Core Word (DocIO) library without Microsoft Word or interop dependencies.
+platform: document-processing
+control: DocIO
+documentation: UG
+---
+
+# Convert Word document to Image in ASP.NET Core Web API
+
+Syncfusion<sup>&reg;</sup> DocIO is a [.NET Core Word library](https://www.syncfusion.com/document-processing/word-framework/net-core/word-library) used to create, read, edit, and **convert Word documents** programmatically without **Microsoft Word** or interop dependencies. Using this library, you can **convert a Word document to image in ASP.NET Core Web API**.
+
+## Steps to convert Word document to Image in programmatically:
+
+The below steps illustrate convert a simple Word document to Image in ASP.NET Core Web API.
+
+Step 1: Create a new C# ASP.NET Core Web API project.
+
+![Create ASP.NET Core Web API project in Visual Studio](ASP-NET-Core-WEB-API-images/ASP-NET-Core-Web-API-template.png)
+
+Step 2: Install the [Syncfusion.DocIORenderer.Net.Core](https://www.nuget.org/packages/Syncfusion.DocIORenderer.Net.Core) NuGet package as a reference to your project from [NuGet.org](https://www.nuget.org).
+
+![Install Syncfusion.DocIORenderer.Net.Core NuGet Package](ASP-NET-Core-WEB-API-images/Word-to-Image-Nuget-package.png)
+
+N> 1. If you're deploying the application in a Linux environment, refer to the [documentation](https://help.syncfusion.com/document-processing/word/conversions/word-to-image/net/nuget-packages-required-word-to-image#additional-nuget-packages-required-for-linux) for the required additional NuGet packages.
+N> 2. Starting with v16.2.0.x, if you reference Syncfusion<sup>&reg;</sup> assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion<sup>&reg;</sup> license key in your application to use our components.
+
+Step 3: Add a new API controller empty file in the project.
+
+![Add empty API controller to the project](ASP-NET-Core-WEB-API-images/Word-to-Image-new-controller.png)
+
+Step 4: Include the following namespaces in the **ValuesController.cs** file.
+
+{% tabs %}
+
+{% highlight c# tabtitle="C#" %}
+
+using Microsoft.AspNetCore.Mvc;
+using Syncfusion.DocIO;
+using Syncfusion.DocIO.DLS;
+using Syncfusion.DocIORenderer;
+
+{% endhighlight %}
+
+{% endtabs %}
+
+Step 5: Add a new action method ConvertWordToImage in **ValuesController.cs** and include the below code snippet to Convert Word document to image and download it.
+
+{% tabs %}
+
+{% highlight c# tabtitle="C#" %}
+
+[HttpGet]
+[Route("api/ConvertWordToImage")]
+public IActionResult ConvertWordToImage()
+{
+    try
+    {
+        var fileDownloadName = "Output.jpeg";
+        const string contentType = "image/jpeg";
+        var stream = ConvertWordDocumentToImage();
+        stream.Position = 0;
+        return File(stream, contentType, fileDownloadName);
+    }
+    catch (Exception ex)
+    {
+        return BadRequest("Error occurred while converting Word to Image: " + ex.Message);
+    }
+}
+ 
+{% endhighlight %}
+
+{% endtabs %}
+
+Step 6: Implement the `ConvertWordDocumentToImage` method in `ValuesController.cs`.
+ 
+{% tabs %}
+
+{% highlight c# tabtitle="C#" %}
+
+public static Stream ConvertWordDocumentToImage()
+{
+    // Loads the input Word document
+    WordDocument wordDocument = new WordDocument(Path.GetFullPath("Data/Input.docx"), FormatType.Docx);   
+    DocIORenderer render = new DocIORenderer();
+    // Convert the first page of the Word document into an image.
+    Stream imageStream = wordDocument.RenderAsImages(0, ExportImageFormat.Jpeg);
+    // Close the Word document.
+    wordDocument.Close();
+    // Reset the stream position.
+    imageStream.Position = 0;
+    // Save the image file.
+    return imageStream;                    
+}
+
+{% endhighlight %}
+
+{% endtabs %}
+
+Step 7: Build the project.
+
+Click on Build → Build Solution or press <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>B</kbd> to build the project.
+
+Step 8: Run the project.
+
+Click the Start button (green arrow) or press <kbd>F5</kbd> to run the app.
+
+A complete working sample is available on [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Word-to-Image-conversion/Convert-Word-to-image/ASP.NET-Core-Web-API/Convert-Word-Document-to-Image).
+
+## Steps for accessing the Web API using HTTP requests
+
+Step 1: Create a console application.
+![Create a Console application in Visual Studio](ASP-NET-Core-WEB-API-images/Console-Template-Net-Core.png)
+
+N> Ensure your ASP.NET Core Web API is running on the specified port before running this client. Adjust the port number if your Web API runs on a different port (check the ASP.NET Core app's launch settings).
+
+Step 2: Add the below code snippet in the **Program.cs** file for accessing the Web API using HTTP requests. 
+
+This method sends a GET request to the Web API endpoint to retrieve and save the generated image.
+
+{% tabs %}
+
+{% highlight c# tabtitle="C#" %}
+
+// Create an HttpClient instance
+using (HttpClient client = new HttpClient())
+{
+    try
+    {
+        // Send a GET request to a URL
+        HttpResponseMessage response = await client.GetAsync("https://localhost:7112/api/Values/api/ConvertWordToImage");
+
+        // Check if the response is successful
+        if (response.IsSuccessStatusCode)
+        {
+            // Read the content as a string
+            Stream responseBody = await response.Content.ReadAsStreamAsync();
+            FileStream fileStream = File.Create("../../../Output/Output.jpeg");
+            responseBody.CopyTo(fileStream);
+            fileStream.Close();
+        }
+        else
+        {
+            Console.WriteLine("HTTP error status code: " + response.StatusCode);
+        }
+    }
+    catch (HttpRequestException e)
+    {
+        Console.WriteLine("Request exception: " + e.Message);
+    }
+}
+
+{% endhighlight %}
+
+{% endtabs %}
+
+Step 3: Build the project.
+
+Click on Build → Build Solution or press <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>B</kbd> to build the project.
+
+Step 4: Run the project.
+
+Click the Start button (green arrow) or press <kbd>F5</kbd> to run the app.
+
+A complete working sample is available on [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Word-to-Image-conversion/Convert-Word-to-image/ASP.NET-Core-Web-API/Client-Application).
+
+Upon executing the program, the **image** will be generated as follows.
+
+![ASP .NET Core WEB API output Word document](WordToPDF_images/Output-WordtoImage.png)
+
+Click [here](https://www.syncfusion.com/document-processing/word-framework/net) to explore the rich set of Syncfusion<sup>&reg;</sup> Word library (DocIO) features.
+
+An online sample link to [convert Word document to image](https://document.syncfusion.com/demos/word/wordtoimage#/tailwind) in ASP.NET Core.

Document-Processing/Word/Conversions/Word-To-Image/NET/ASP-NET-Core-WEB-API-images/Console-Template-Net-Core.png

@@ -0,0 +1,178 @@
+---
+title: Convert Word to PDF in ASP.NET Core Web API | Syncfusion
+description: Convert Word to PDF in ASP.NET Core Web API using .NET Core Word (DocIO) library without Microsoft Word or interop dependencies.
+platform: document-processing
+control: DocIO
+documentation: UG
+---
+
+# Convert Word document to PDF in ASP.NET Core Web API
+
+Syncfusion<sup>&reg;</sup> DocIO is a [.NET Core Word library](https://www.syncfusion.com/document-processing/word-framework/net-core/word-library) used to create, read, edit, and **convert Word documents** programmatically without **Microsoft Word** or interop dependencies. Using this library, you can **convert a Word document to PDF in ASP.NET Core Web API**.
+
+## Steps to convert Word document to PDF in programmatically:
+
+The below steps illustrate convert a simple Word document to PDF in ASP.NET Core Web API.
+
+Step 1: Create a new C# ASP.NET Core Web API project.
+
+![Create ASP.NET Core Web API project in Visual Studio](ASP-NET-Core-WEB-API-images/ASP-NET-Core-Web-API-template.png)
+
+Step 2: Install the [Syncfusion.DocIORenderer.Net.Core](https://www.nuget.org/packages/Syncfusion.DocIORenderer.Net.Core) NuGet package as a reference to your project from [NuGet.org](https://www.nuget.org).
+
+![Install Syncfusion.DocIORenderer.Net.Core NuGet Package](ASP-NET-Core-WEB-API-images/Word-to-PDF-Nuget-Package.png)
+
+N> 1. If you're deploying the application in a Linux environment, refer to the [documentation](https://help.syncfusion.com/document-processing/word/conversions/word-to-image/net/nuget-packages-required-word-to-image#additional-nuget-packages-required-for-linux) for the required additional NuGet packages.
+N> 2. Starting with v16.2.0.x, if you reference Syncfusion<sup>&reg;</sup> assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion<sup>&reg;</sup> license key in your application to use our components.
+
+Step 3: Add a new API controller empty file in the project.
+
+![Add empty API controller to the project](ASP-NET-Core-WEB-API-images/Word-to-PDF-new-controller.png)
+
+Step 4: Include the following namespaces in the **ValuesController.cs** file.
+
+{% tabs %}
+
+{% highlight c# tabtitle="C#" %}
+
+using Microsoft.AspNetCore.Mvc;
+using Syncfusion.DocIO;
+using Syncfusion.DocIO.DLS;
+using Syncfusion.DocIORenderer;
+using Syncfusion.Pdf;
+
+{% endhighlight %}
+
+{% endtabs %}
+
+Step 5: Add a new action method ConvertWordToPdf in **ValuesController.cs** and include the below code snippet to Convert Word document to PDF and download it.
+
+{% tabs %}
+
+{% highlight c# tabtitle="C#" %}
+
+[HttpGet]
+[Route("api/ConvertWordToPdf")]
+public IActionResult ConvertWordToPdf()
+{
+    try
+    {
+        var fileDownloadName = "Output.pdf";
+        const string contentType = "application/pdf";
+        var stream = ConvertWordDocumentToPdf();
+        stream.Position = 0;
+        return File(stream, contentType, fileDownloadName);
+    }
+    catch (Exception ex)
+    {
+        return BadRequest("Error occurred while converting Word to PDF: " + ex.Message);
+    }
+}
+ 
+{% endhighlight %}
+
+{% endtabs %}
+
+Step 6: Implement the `ConvertWordDocumentToPdf` method in `ValuesController.cs`.
+ 
+{% tabs %}
+
+{% highlight c# tabtitle="C#" %}
+
+public static MemoryStream ConvertWordDocumentToPdf()
+{
+    //Open the existing PowerPoint presentation with loaded stream.
+    using (WordDocument wordDocument = new WordDocument(Path.GetFullPath("Data/Template.docx")))
+    {
+        using (DocIORenderer render = new DocIORenderer())
+        {
+            PdfDocument pdfDocument = render.ConvertToPDF(wordDocument);
+            //Create the MemoryStream to save the converted PDF.      
+            MemoryStream pdfStream = new MemoryStream();
+            //Save the converted PDF document to MemoryStream.
+            pdfDocument.Save(pdfStream);
+            pdfStream.Position = 0;
+            //Download PDF document in the browser.
+            return pdfStream;
+        }
+    }
+}
+
+{% endhighlight %}
+
+{% endtabs %}
+
+Step 7: Build the project.
+
+Click on Build → Build Solution or press <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>B</kbd> to build the project.
+
+Step 8: Run the project.
+
+Click the Start button (green arrow) or press <kbd>F5</kbd> to run the app.
+
+A complete working sample is available on [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Word-to-PDF-Conversion/Convert-Word-document-to-PDF/ASP.NET-Core-Web-API/Convert-Word-Document-to-PDF).
+
+## Steps for accessing the Web API using HTTP requests
+
+Step 1: Create a console application.
+![Create a Console application in Visual Studio](ASP-NET-Core-WEB-API-images/Console-Template-Net-Core.png)
+
+N> Ensure your ASP.NET Core Web API is running on the specified port before running this client. Adjust the port number if your Web API runs on a different port (check the ASP.NET Core app's launch settings).
+
+Step 2: Add the below code snippet in the **Program.cs** file for accessing the Web API using HTTP requests. 
+
+This method sends a GET request to the Web API endpoint to retrieve and save the generated PDF document.
+
+{% tabs %}
+
+{% highlight c# tabtitle="C#" %}
+
+// Create an HttpClient instance
+using (HttpClient client = new HttpClient())
+{
+    try
+    {
+        // Send a GET request to a URL
+        HttpResponseMessage response = await client.GetAsync("https://localhost:7240/api/Values/api/ConvertWordToPdf");
+
+        // Check if the response is successful
+        if (response.IsSuccessStatusCode)
+        {
+            // Read the content as a string
+            Stream responseBody = await response.Content.ReadAsStreamAsync();
+            FileStream fileStream = File.Create("../../../Output/Output.pdf");
+            responseBody.CopyTo(fileStream);
+            fileStream.Close();
+        }
+        else
+        {
+            Console.WriteLine("HTTP error status code: " + response.StatusCode);
+        }
+    }
+    catch (HttpRequestException e)
+    {
+        Console.WriteLine("Request exception: " + e.Message);
+    }
+}
+
+{% endhighlight %}
+
+{% endtabs %}
+
+Step 3: Build the project.
+
+Click on Build → Build Solution or press <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>B</kbd> to build the project.
+
+Step 4: Run the project.
+
+Click the Start button (green arrow) or press <kbd>F5</kbd> to run the app.
+
+A complete working sample is available on [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Word-to-PDF-Conversion/Convert-Word-document-to-PDF/ASP.NET-Core-Web-API/Client-Application).
+
+Upon executing the program, the **PDF** will be generated as follows.
+
+![ASP .NET Core WEB API output Word document](ASP-NET-Core-WEB-API-images/ASP-NET-Core-Web-API-Output.png)
+
+Click [here](https://www.syncfusion.com/document-processing/word-framework/net) to explore the rich set of Syncfusion<sup>&reg;</sup> Word library (DocIO) features.
+
+An online sample link to [convert Word document to PDF](https://document.syncfusion.com/demos/word/wordtopdf#/tailwind) in ASP.NET Core.