Create a blank ASP.NET MVC5 application.

Server side: Add references to the Vintasoft assemblies to ASP.NET MVC5 application.

Server side: Specify drawing engine, which should be used by VintaSoft Imaging .NET SDK for drawing of 2D graphics.

• Add reference to the Vintasoft.Imaging.Gdi.dll assembly.
  
• Open "Global.asax.cs" file, add code line "Vintasoft.Imaging.Drawing.Gdi.GdiGraphicsFactory.SetAsDefault();" at the beginning of Application_Start method - added code specifies that VintaSoft Imaging .NET SDK should use System.Drawing library for drawing of 2D graphics.

Server side: Create web services, which allow to upload/download file and view DICOM images.

• Create web service that allows to upload/download file

  • Press the right mouse button on the "Controllers" folder and select the "Add => Controller..." menu from context menu
    
  • Select "Empty API controller" template, set the controller name to the "MyVintasoftFileApiController" and press the "Add" button
    
  • Specify that MyVintasoftFileApiController class is derived from Vintasoft.Imaging.Web.Api2Controllers.VintasoftFileApi2Controller class
    
    Here are source codes of MyVintasoftFileApiController class:
    
    • C#

    namespace WebApplication1.Controllers
    {
        public class MyVintasoftFileApiController : Vintasoft.Imaging.Web.Api2Controllers.VintasoftFileApi2Controller
        {
    
            public MyVintasoftFileApiController()
                : base()
            {
            }
    
        }
    }
    
    

    
    

• Create web service that allows to work with DICOM images

  • Press the right mouse button on the "Controllers" folder and select the "Add => Controller..." menu from context menu
    
  • Select "Empty API controller" template, set the controller name to the "MyVintasoftDicomApiController" and press the "Add" button
    
  • Specify that MyVintasoftDicomApiController class is derived from Vintasoft.Imaging.Dicom.Web.Api2Controllers.VintasoftDicomApi2Controller class
    
    Here are source codes of MyVintasoftDicomApiController class:
    
    • C#

    using Vintasoft.Imaging.Dicom.Web.Api2Controllers;
    
    namespace WebApplication1.Controllers
    {
        /// <summary>
        /// A Web API controller that handles HTTP requests from clients and
        /// allows to work with DICOM images.
        /// </summary>
        public class MyVintasoftDicomApiController : VintasoftDicomApi2Controller
        {
    
            /// <summary>
            /// Initializes a new instance of the <see cref="MyVintasoftDicomApiController"/> class.
            /// </summary>
            public MyVintasoftDicomApiController()
                : base()
            {
            }
    
        }
    }
    

    
    
• Open "App_Start\WebApiConfig.cs" file and check that ASP.NET MVC application correctly registers route for Web API controller.
  
  Here are C# source codes of WebApiConfig.cs file:
  
  • C#

  using System.Web.Http;
  
  namespace WebApplication1
  {
      public static class WebApiConfig
      {
          public static void Register(HttpConfiguration config)
          {
              config.Routes.MapHttpRoute(
                  name: "DemoAPI",
                  routeTemplate: "vintasoft/api/{controller}/{action}"
              );
          }
      }
  }
  
  

Server side: Create ASP.NET MVC 5 controller for web view that will display DICOM viewer.

• Press the right mouse button on the "Controllers" folder and select the "Add => Controller..." menu from context menu
  
  
  
• Select "MVC 5 Controller - Empty" template, set the controller name to the "DefaultController" and press the "Add" button
  
  
  
• Open "App_Start\RouteConfig.cs" file and check that ASP.NET MVC application correctly registers route for MVC controller.
  
  Here are C# source codes of RouteConfig.cs file:
  
  • C#

  using System.Web.Mvc;
  using System.Web.Routing;
  
  namespace WebApplication1
  {
      public class RouteConfig
      {
          public static void RegisterRoutes(RouteCollection routes)
          {
              routes.IgnoreRoute("{resource}.axd/{*pathInfo}");
  
              routes.MapRoute(
                  name: "Default",
                  url: "{controller}/{action}",
                  defaults: new { controller = "Default", action = "Index" }
              );
          }
      }
  }
  
  
  

Server side: Check global configuration of ASP.NET MVC5 application.

using System.Web.Http;
using System.Web.Mvc;
using System.Web.Routing;

namespace WebApplication1
{
    public class WebApiApplication : System.Web.HttpApplication
    {
        protected void Application_Start()
        {
            AreaRegistration.RegisterAllAreas();
            GlobalConfiguration.Configure(WebApiConfig.Register);
            RouteConfig.RegisterRoutes(RouteTable.Routes);
        }
    }
}

Client side: Create web view for displaying DICOM viewer.

• Open "DefaultController.cs" file, press the right mouse button on the "Index" method of DefaultController class and select the "Add View..." menu from context menu
  
• Select "MVC 5 View" template, click "Add" button, set view name to "Index", uncheck "Use a layout page" checkbox and press the "Add" button => "Views\Default\Index.cshtml" file will be created
  

Client side: Add JavaScript libraries to the project.

• Add the "Scripts\" folder to ASP.NET MVC application if folder does not exist.
  
  
• Copy Vintasoft.Shared.js, Vintasoft.Imaging.js, Vintasoft.Imaging.Dicom.js and Vintasoft.Imaging.Dicom.css files from "<InstallPath>\VintaSoft Imaging .NET v12.5\Bin\JavaScript\" folder into "Scripts\" folder.
  
  
• Specify, which "standard" dialogs (password dialog, print dialog, etc) should be used by web DICOM viewer
  • If web DICOM viewer should use ready-to-use "standard" jQuery UI dialogs (modern dialogs with ability to move dialog):
    • Copy jQuery file into "Scripts\" folder.
      You can use "jquery-3.3.1.min.js" file from "<InstallPath>\VintaSoft Imaging .NET v12.5\Examples\ASP.NET MVC\CSharp\AspNetMvcImagingDemo\Scripts\External\" folder or jQuery file from any other source.
    • Copy jQuery UI files and folders into "Scripts\" folder.
      You can use "jquery-ui.min.js" file and "jquery-ui-css" folder from "<InstallPath>\VintaSoft Imaging .NET v12.5\Examples\ASP.NET MVC\CSharp\AspNetMvcImagingDemo\Scripts\External\" folder or jQuery UI files and folders from any other source.
    • Copy Vintasoft.Imaging.Dialogs.jQueryUI.js and Vintasoft.Imaging.Dicom.Dialogs.jQueryUI.js files from "<InstallPath>\VintaSoft Imaging .NET v12.5\Bin\JavaScript\" folder into "Scripts\" folder.
      
      
  • If web DICOM viewer should use custom "standard" dialogs,please read how to create custom "standard" dialogs here.

Client side: Add JavaScript code that allows to display document, search and extract text from document, annotate document.

• Create folder "UploadedImageFiles\SessionID" and copy test DICOM file "<SdkInstallPath>\VintaSoft\Imaging .NET v12.5\Examples\ASP.NET Core\CSharp\AspNetCoreImagingDemo\wwwroot\UploadedImageFiles\LossyJpeg_Monochrome2_000.0000.dcm" to the folder. This file will be displayed in DICOM viewer.
  
  
• Open web view - file "Views\Default\Index.cshtml".
  
  
  
• Add references to Vintasoft JavaScript files:
  
  Here is HTML code that adds references to jQuery and Vintasoft JavaScript files:
  
  • HTML

  <link rel="stylesheet" type="text/css" href="~/Scripts/jquery-ui-css/jquery-ui.min.css">
  <link rel="stylesheet" type="text/css" href="~/Scripts/Vintasoft.Imaging.css">
  <link rel="stylesheet" type="text/css" href="~/Scripts/Vintasoft.Imaging.Dicom.css">
  
  <script src="~/Scripts/jquery-3.3.1.min.js" type="text/javascript"></script>
  <script src="~/Scripts/jquery-ui.min.js" type="text/javascript"></script>
  
  <script src="~/Scripts/Vintasoft.Shared.js" type="text/javascript"></script>
  <script src="~/Scripts/Vintasoft.Imaging.js" type="text/javascript"></script>
  <script src="~/Scripts/Vintasoft.Imaging.Dicom.js" type="text/javascript"></script>
  <script src="~/Scripts/Vintasoft.Imaging.Dialogs.jQueryUI.js" type="text/javascript"></script>
  <script src="~/Scripts/Vintasoft.Imaging.Dicom.Dialogs.jQueryUI.js" type="text/javascript"></script>
  

  
  
  
• Add HTML markup (a div-element that will display DICOM viewer) to the web view:
  
  Here is HTML markup code:
  
  • HTML

  <h1 style="text-align: center">VintaSoft DICOM Viewer Demo (ASP.NET Core MVC5)</h1>
  
  <div id="dicomControlContainer" style="height: 800px"></div>
  

  
  
  
• Add JavaScript code that initializes and creates DICOM viewer:
  
  Here is JavaScript code that initializes and creates DICOM viewer:
  
  • JavaScript

  @{
      Layout = null;
  }
  
  <!DOCTYPE html>
  
  <html>
  <head>
      <meta name="viewport" content="width=device-width" />
      <title>VintaSoft DICOM Viewer Demo (ASP.NET MVC5)</title>
  
      <style>
          * {
              -webkit-box-sizing: border-box;
              box-sizing: border-box;
              border-collapse: collapse;
          }
      </style>
  
      <link rel="stylesheet" type="text/css" href="~/Scripts/jquery-ui-css/jquery-ui.min.css">
      <link rel="stylesheet" type="text/css" href="~/Scripts/Vintasoft.Imaging.css">
      <link rel="stylesheet" type="text/css" href="~/Scripts/Vintasoft.Imaging.Dicom.css">
  
      <script src="~/Scripts/jquery-3.3.1.min.js" type="text/javascript"></script>
      <script src="~/Scripts/jquery-ui.min.js" type="text/javascript"></script>
  
      <script src="~/Scripts/Vintasoft.Shared.js" type="text/javascript"></script>
      <script src="~/Scripts/Vintasoft.Imaging.js" type="text/javascript"></script>
      <script src="~/Scripts/Vintasoft.Imaging.Dicom.js" type="text/javascript"></script>
      <script src="~/Scripts/Vintasoft.Imaging.Dialogs.jQueryUI.js" type="text/javascript"></script>
      <script src="~/Scripts/Vintasoft.Imaging.Dicom.Dialogs.jQueryUI.js" type="text/javascript"></script>
  </head>
  <body>
      <h1 style="text-align: center">VintaSoft DICOM Viewer Demo (ASP.NET Core MVC5)</h1>
  
      <div id="dicomControlContainer" style="height: 800px"></div>
  
      <script type="text/javascript">
          // set the session identifier
          Vintasoft.Shared.WebImagingEnviromentJS.set_SessionId("SessionID");
  
          // specify web services, which should be used by Vintasoft Web DICOM Viewer
          Vintasoft.Shared.WebServiceJS.defaultFileService =
              new Vintasoft.Shared.WebServiceControllerJS("vintasoft/api/MyVintasoftFileApi");
          Vintasoft.Shared.WebServiceJS.defaultDicomService =
              new Vintasoft.Shared.WebServiceControllerJS("vintasoft/api/MyVintasoftDicomApi");
  
          // create DICOM control settings
          var dicomControlSettings = new Vintasoft.Imaging.Dicom.WebDicomControlSettingsJS("dicomControlContainer", "dicomControl");
          // create DICOM control
          var dicomControl = new Vintasoft.Imaging.Dicom.WebDicomControlJS(dicomControlSettings);
  
          // subscribe to the "warningOccured" event of DICOM control
          Vintasoft.Shared.subscribeToEvent(dicomControl, "warningOccured", function (event, eventArgs) { alert(eventArgs.message); });
  
          // add DICOM file "LossyJpeg_Monochrome2_000.0000.dcm" to the DICOM control
          dicomControl.addFiles(["LossyJpeg_Monochrome2_000.0000.dcm"]);
      </script>
  </body>
  </html>
  
  

Run the ASP.NET MVC5 application and see the result.