Merge pull request #63 from SyncfusionExamples/PPT-Azure

Add samples for opening and saving PowerPoint document in Azure Blob cloud storage

Read-and-save-PowerPoint-presentation/Open-and-save-PowerPoint/Azure-Blob-Storage/Open-PowerPoint-document/Open-PowerPoint-document.sln

@@ -0,0 +1,25 @@
+
+Microsoft Visual Studio Solution File, Format Version 12.00
+# Visual Studio Version 17
+VisualStudioVersion = 17.10.34928.147
+MinimumVisualStudioVersion = 10.0.40219.1
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Open-PowerPoint-document", "Open-PowerPoint-document\Open-PowerPoint-document.csproj", "{90C38505-7EE1-45BC-ACC9-D53756265E75}"
+EndProject
+Global
+	GlobalSection(SolutionConfigurationPlatforms) = preSolution
+		Debug|Any CPU = Debug|Any CPU
+		Release|Any CPU = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(ProjectConfigurationPlatforms) = postSolution
+		{90C38505-7EE1-45BC-ACC9-D53756265E75}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{90C38505-7EE1-45BC-ACC9-D53756265E75}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{90C38505-7EE1-45BC-ACC9-D53756265E75}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{90C38505-7EE1-45BC-ACC9-D53756265E75}.Release|Any CPU.Build.0 = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(SolutionProperties) = preSolution
+		HideSolutionNode = FALSE
+	EndGlobalSection
+	GlobalSection(ExtensibilityGlobals) = postSolution
+		SolutionGuid = {AD7BC10B-9552-4491-8A9A-3BE6A270AEF8}
+	EndGlobalSection
+EndGlobal

Read-and-save-PowerPoint-presentation/Open-and-save-PowerPoint/Azure-Blob-Storage/Open-PowerPoint-document/Open-PowerPoint-document/Controllers/HomeController.cs

@@ -0,0 +1,111 @@
+using Azure.Storage.Blobs.Models;
+using Azure.Storage.Blobs;
+using Microsoft.AspNetCore.Mvc;
+using Open_PowerPoint_document.Models;
+using System.Diagnostics;
+using Syncfusion.Presentation;
+
+namespace Open_PowerPoint_document.Controllers
+{
+    public class HomeController : Controller
+    {
+        private readonly ILogger<HomeController> _logger;
+
+        public HomeController(ILogger<HomeController> logger)
+        {
+            _logger = logger;
+        }
+
+        public IActionResult Index()
+        {
+            return View();
+        }
+        public async Task<IActionResult> EditDocument()
+        {
+            //Your Azure Storage Account connection string
+            string connectionString = "Your_connection_string";
+
+            //Name of the Azure Blob Storage container
+            string containerName = "Your_container_name";
+
+            //Name of the Powerpoint file you want to load
+            string blobName = "PowerPointTemplate.pptx";
+
+            try
+            {
+                //Retrieve the document from Azure
+                MemoryStream stream = await GetDocumentFromAzure(connectionString, containerName, blobName);
+
+                //Set the position to the beginning of the MemoryStream
+                stream.Position = 0;
+
+                //Create an instance of PowerPoint Presentation file
+                using (IPresentation pptxDocument = Presentation.Open(stream))
+                {
+                    //Get the first slide from the PowerPoint presentation
+                    ISlide slide = pptxDocument.Slides[0];
+
+                    //Get the first shape of the slide
+                    IShape shape = slide.Shapes[0] as IShape;
+
+                    //Change the text of the shape
+                    if (shape.TextBody.Text == "Company History")
+                        shape.TextBody.Text = "Company Profile";
+
+                    //Saving the PowerPoint document to a MemoryStream 
+                    MemoryStream outputStream = new MemoryStream();
+                    pptxDocument.Save(outputStream);
+
+                    //Download the PowerPoint file in the browser
+                    FileStreamResult fileStreamResult = new FileStreamResult(outputStream, "application/powerpoint");
+                    fileStreamResult.FileDownloadName = "EditPowerPoint.pptx";
+                    return fileStreamResult;
+                }
+
+            }
+            catch (Exception ex)
+            {
+                Console.WriteLine($"Error: {ex.Message}");
+                return Content("Error occurred while processing the file.");
+            }
+        }
+        /// <summary>
+        /// Download file from Azure Blob cloud storage
+        /// </summary>
+        /// <param name="bucketName"></param>
+        /// <param name="key"></param>
+        /// <returns></returns>
+        public async Task<MemoryStream> GetDocumentFromAzure(string connectionString, string containerName, string blobName)
+        {
+            try
+            {
+                //Download the PowerPoint document from Azure Blob Storage
+                BlobServiceClient blobServiceClient = new BlobServiceClient(connectionString);
+                BlobContainerClient containerClient = blobServiceClient.GetBlobContainerClient(containerName);
+                BlobClient blobClient = containerClient.GetBlobClient(blobName);
+                BlobDownloadInfo download = await blobClient.DownloadAsync();
+
+                //Create a MemoryStream to copy the file content
+                MemoryStream stream = new MemoryStream();
+                await download.Content.CopyToAsync(stream);
+
+                return stream;
+            }
+            catch (Exception ex)
+            {
+                Console.WriteLine($"Error retrieving document from Azure Blob Storage: {ex.Message}");
+                throw; // or handle the exception as needed
+            }
+        }
+        public IActionResult Privacy()
+        {
+            return View();
+        }
+
+        [ResponseCache(Duration = 0, Location = ResponseCacheLocation.None, NoStore = true)]
+        public IActionResult Error()
+        {
+            return View(new ErrorViewModel { RequestId = Activity.Current?.Id ?? HttpContext.TraceIdentifier });
+        }
+    }
+}

Read-and-save-PowerPoint-presentation/Open-and-save-PowerPoint/Azure-Blob-Storage/Open-PowerPoint-document/Open-PowerPoint-document/Models/ErrorViewModel.cs

@@ -0,0 +1,9 @@
+namespace Open_PowerPoint_document.Models
+{
+    public class ErrorViewModel
+    {
+        public string? RequestId { get; set; }
+
+        public bool ShowRequestId => !string.IsNullOrEmpty(RequestId);
+    }
+}

Read-and-save-PowerPoint-presentation/Open-and-save-PowerPoint/Azure-Blob-Storage/Open-PowerPoint-document/Open-PowerPoint-document/Open-PowerPoint-document.csproj

@@ -0,0 +1,15 @@
+<Project Sdk="Microsoft.NET.Sdk.Web">
+
+  <PropertyGroup>
+    <TargetFramework>net8.0</TargetFramework>
+    <Nullable>enable</Nullable>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <RootNamespace>Open_PowerPoint_document</RootNamespace>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Azure.Storage.Blobs" Version="12.20.0" />
+    <PackageReference Include="Syncfusion.Presentation.Net.Core" Version="26.1.40" />
+  </ItemGroup>
+
+</Project>

Read-and-save-PowerPoint-presentation/Open-and-save-PowerPoint/Azure-Blob-Storage/Open-PowerPoint-document/Open-PowerPoint-document/Program.cs

@@ -0,0 +1,27 @@
+var builder = WebApplication.CreateBuilder(args);
+
+// Add services to the container.
+builder.Services.AddControllersWithViews();
+
+var app = builder.Build();
+
+// Configure the HTTP request pipeline.
+if (!app.Environment.IsDevelopment())
+{
+    app.UseExceptionHandler("/Home/Error");
+    // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
+    app.UseHsts();
+}
+
+app.UseHttpsRedirection();
+app.UseStaticFiles();
+
+app.UseRouting();
+
+app.UseAuthorization();
+
+app.MapControllerRoute(
+    name: "default",
+    pattern: "{controller=Home}/{action=Index}/{id?}");
+
+app.Run();

Read-and-save-PowerPoint-presentation/Open-and-save-PowerPoint/Azure-Blob-Storage/Open-PowerPoint-document/Open-PowerPoint-document/Properties/launchSettings.json

@@ -0,0 +1,38 @@
+{
+  "$schema": "http://json.schemastore.org/launchsettings.json",
+  "iisSettings": {
+    "windowsAuthentication": false,
+    "anonymousAuthentication": true,
+    "iisExpress": {
+      "applicationUrl": "http://localhost:30783",
+      "sslPort": 44309
+    }
+  },
+  "profiles": {
+    "http": {
+      "commandName": "Project",
+      "dotnetRunMessages": true,
+      "launchBrowser": true,
+      "applicationUrl": "http://localhost:5230",
+      "environmentVariables": {
+        "ASPNETCORE_ENVIRONMENT": "Development"
+      }
+    },
+    "https": {
+      "commandName": "Project",
+      "dotnetRunMessages": true,
+      "launchBrowser": true,
+      "applicationUrl": "https://localhost:7119;http://localhost:5230",
+      "environmentVariables": {
+        "ASPNETCORE_ENVIRONMENT": "Development"
+      }
+    },
+    "IIS Express": {
+      "commandName": "IISExpress",
+      "launchBrowser": true,
+      "environmentVariables": {
+        "ASPNETCORE_ENVIRONMENT": "Development"
+      }
+    }
+  }
+}

Read-and-save-PowerPoint-presentation/Open-and-save-PowerPoint/Azure-Blob-Storage/Open-PowerPoint-document/Open-PowerPoint-document/Views/Home/Index.cshtml

@@ -0,0 +1,13 @@
+@{
+    ViewData["Title"] = "Home Page";
+}
+
+@{
+    Html.BeginForm("EditDocument", "Home", FormMethod.Get);
+    {
+                <div>
+                    <input type="submit" value="Edit Document" style="width:150px;height:27px" />
+                </div>
+    }
+    Html.EndForm();
+}

Read-and-save-PowerPoint-presentation/Open-and-save-PowerPoint/Azure-Blob-Storage/Open-PowerPoint-document/Open-PowerPoint-document/Views/Home/Privacy.cshtml

@@ -0,0 +1,6 @@
+@{
+    ViewData["Title"] = "Privacy Policy";
+}
+<h1>@ViewData["Title"]</h1>
+
+<p>Use this page to detail your site's privacy policy.</p>

Read-and-save-PowerPoint-presentation/Open-and-save-PowerPoint/Azure-Blob-Storage/Open-PowerPoint-document/Open-PowerPoint-document/Views/Shared/Error.cshtml

@@ -0,0 +1,25 @@
+@model ErrorViewModel
+@{
+    ViewData["Title"] = "Error";
+}
+
+<h1 class="text-danger">Error.</h1>
+<h2 class="text-danger">An error occurred while processing your request.</h2>
+
+@if (Model.ShowRequestId)
+{
+    <p>
+        <strong>Request ID:</strong> <code>@Model.RequestId</code>
+    </p>
+}
+
+<h3>Development Mode</h3>
+<p>
+    Swapping to <strong>Development</strong> environment will display more detailed information about the error that occurred.
+</p>
+<p>
+    <strong>The Development environment shouldn't be enabled for deployed applications.</strong>
+    It can result in displaying sensitive information from exceptions to end users.
+    For local debugging, enable the <strong>Development</strong> environment by setting the <strong>ASPNETCORE_ENVIRONMENT</strong> environment variable to <strong>Development</strong>
+    and restarting the app.
+</p>

Read-and-save-PowerPoint-presentation/Open-and-save-PowerPoint/Azure-Blob-Storage/Open-PowerPoint-document/Open-PowerPoint-document/Views/Shared/_Layout.cshtml

@@ -0,0 +1,49 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>@ViewData["Title"] - Open_PowerPoint_document</title>
+    <link rel="stylesheet" href="~/lib/bootstrap/dist/css/bootstrap.min.css" />
+    <link rel="stylesheet" href="~/css/site.css" asp-append-version="true" />
+    <link rel="stylesheet" href="~/Open_PowerPoint_document.styles.css" asp-append-version="true" />
+</head>
+<body>
+    <header>
+        <nav class="navbar navbar-expand-sm navbar-toggleable-sm navbar-light bg-white border-bottom box-shadow mb-3">
+            <div class="container-fluid">
+                <a class="navbar-brand" asp-area="" asp-controller="Home" asp-action="Index">Open_PowerPoint_document</a>
+                <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target=".navbar-collapse" aria-controls="navbarSupportedContent"
+                        aria-expanded="false" aria-label="Toggle navigation">
+                    <span class="navbar-toggler-icon"></span>
+                </button>
+                <div class="navbar-collapse collapse d-sm-inline-flex justify-content-between">
+                    <ul class="navbar-nav flex-grow-1">
+                        <li class="nav-item">
+                            <a class="nav-link text-dark" asp-area="" asp-controller="Home" asp-action="Index">Home</a>
+                        </li>
+                        <li class="nav-item">
+                            <a class="nav-link text-dark" asp-area="" asp-controller="Home" asp-action="Privacy">Privacy</a>
+                        </li>
+                    </ul>
+                </div>
+            </div>
+        </nav>
+    </header>
+    <div class="container">
+        <main role="main" class="pb-3">
+            @RenderBody()
+        </main>
+    </div>
+
+    <footer class="border-top footer text-muted">
+        <div class="container">
+            &copy; 2024 - Open_PowerPoint_document - <a asp-area="" asp-controller="Home" asp-action="Privacy">Privacy</a>
+        </div>
+    </footer>
+    <script src="~/lib/jquery/dist/jquery.min.js"></script>
+    <script src="~/lib/bootstrap/dist/js/bootstrap.bundle.min.js"></script>
+    <script src="~/js/site.js" asp-append-version="true"></script>
+    @await RenderSectionAsync("Scripts", required: false)
+</body>
+</html>

Read-and-save-PowerPoint-presentation/Open-and-save-PowerPoint/Azure-Blob-Storage/Open-PowerPoint-document/Open-PowerPoint-document/Views/Shared/_Layout.cshtml.css

@@ -0,0 +1,48 @@
+/* Please see documentation at https://learn.microsoft.com/aspnet/core/client-side/bundling-and-minification
+for details on configuring this project to bundle and minify static web assets. */
+
+a.navbar-brand {
+  white-space: normal;
+  text-align: center;
+  word-break: break-all;
+}
+
+a {
+  color: #0077cc;
+}
+
+.btn-primary {
+  color: #fff;
+  background-color: #1b6ec2;
+  border-color: #1861ac;
+}
+
+.nav-pills .nav-link.active, .nav-pills .show > .nav-link {
+  color: #fff;
+  background-color: #1b6ec2;
+  border-color: #1861ac;
+}
+
+.border-top {
+  border-top: 1px solid #e5e5e5;
+}
+.border-bottom {
+  border-bottom: 1px solid #e5e5e5;
+}
+
+.box-shadow {
+  box-shadow: 0 .25rem .75rem rgba(0, 0, 0, .05);
+}
+
+button.accept-policy {
+  font-size: 1rem;
+  line-height: inherit;
+}
+
+.footer {
+  position: absolute;
+  bottom: 0;
+  width: 100%;
+  white-space: nowrap;
+  line-height: 60px;
+}

Read-and-save-PowerPoint-presentation/Open-and-save-PowerPoint/Azure-Blob-Storage/Open-PowerPoint-document/Open-PowerPoint-document/Views/Shared/_ValidationScriptsPartial.cshtml

@@ -0,0 +1,2 @@
+<script src="~/lib/jquery-validation/dist/jquery.validate.min.js"></script>
+<script src="~/lib/jquery-validation-unobtrusive/jquery.validate.unobtrusive.min.js"></script>

Read-and-save-PowerPoint-presentation/Open-and-save-PowerPoint/Azure-Blob-Storage/Open-PowerPoint-document/Open-PowerPoint-document/Views/_ViewImports.cshtml

@@ -0,0 +1,3 @@
+@using Open_PowerPoint_document
+@using Open_PowerPoint_document.Models
+@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers

Read-and-save-PowerPoint-presentation/Open-and-save-PowerPoint/Azure-Blob-Storage/Open-PowerPoint-document/Open-PowerPoint-document/Views/_ViewStart.cshtml

@@ -0,0 +1,3 @@
+@{
+    Layout = "_Layout";
+}

Read-and-save-PowerPoint-presentation/Open-and-save-PowerPoint/Azure-Blob-Storage/Open-PowerPoint-document/Open-PowerPoint-document/appsettings.Development.json

@@ -0,0 +1,8 @@
+{
+  "Logging": {
+    "LogLevel": {
+      "Default": "Information",
+      "Microsoft.AspNetCore": "Warning"
+    }
+  }
+}