VintaSoft Twain .NET SDK 15.1: Документация для Веб разработчика
В этом разделе
    Получение изображений от TWAIN сканера в ASP.NET MVC 5 приложении
    В этом разделе
    В этом руководстве показано, как создать пустое приложение ASP.NET MVC 5 в Visual Studio .NET 2019 и получать изображения от TWAIN сканера в приложении ASP.NET MVC 5.
    Вот действия, которые необходимо выполнить:

    1. Создайте пустое ASP.NET MVC5 приложение.

      Откройте Visual Studio .NET 2019, создайте новый проект приложения типа ASP.NET Web и сконфигурируйте проект для использования .NET Framework 4.7.2:

      Выберите шаблон "Empty" для ASP.NET Web приложения с поддержкой MVC:

    2. Серверная сторона: Добавьте контроллер MVC по умолчанию в ASP.NET MVC приложение.

      • Добавьте папку "Controllers", если папка не существует.
      • Нажмите правой кнопкой мыши на папку "Controllers" и выберите пункт "Add => Controller..." из контекстного меню
      • Выберите шаблон "MVC 5 Controller - Empty", установите имя контроллера в "DefaultController" и нажмите кнопку "Add"
      • Откройте файл "App_Start/RouteConfig.cs" и проверьте, что ASP.NET MVC приложение правильно регистрирует маршрут для контроллера MVC.

        Вот C# коды файла RouteConfig.cs: 
        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" }
            );

        }
    }
}

    3. Клиентская сторона: Создайте веб-представление для отображения изображения, полученного от TWAIN сканера.

      • Откройте файл "DefaultController.cs", нажмите правой кнопкой мыши на метод "Index" класса DefaultController и выберите "Add View..." из контекстного меню
      • Установите вид в "Index", снимите флажок "Use a layout page" и нажмите кнопку "Add" => "Views\Default\Index.cshtml" файл будет создан

    4. Клиентская сторона: Добавьте инсталлятор VintaSoft Web TWAIN сервиса к ASP.NET MVC приложению.

      1. Добавьте папку "Data" в папку проекта.
      2. Загрузите ZIP-архив с Windows инсталлятором для VintaSoft Web TWAIN сервиса по ссылке https://www.vintasoft.ru/zip/VintasoftWebTwainService-15.1.1.zip и скопируйте ZIP-архив в папку "Data".
        VintaSoft Web TWAIN сервис это Windows сервис, который обеспечивает Web API для доступа к локальным TWAIN сканерам для всех пользователей локального компьютера. Больше информации по VintaSoft Web TWAIN сервису можно найти здесь.

    5. Клиентская сторона: Добавьте файлы Vintasoft JavaScript к проекту.

      • Добавьте папку "Scripts" к проекту, если необходимо.
      • Получите файлы Vintasoft.Shared.js и Vintasoft.Twain.js из папки "<SDK_install_path>\Bin\JavaScript\" инсталляции VintaSoft TWAIN .NET SDK или из npm-пакета 'vintasoft-web-twain-js'. Скопируйте Vintasoft JavaScript файлы в папку "Scripts".
      • Откройте файл "Views\Default\Index.cshtml" и добавьте ссылки на файлы Vintasoft JavaScript на Вашу страницу кода: 
        <!DOCTYPE html>

<html>
<head>
    <meta name="viewport" content="width=device-width" />
    <title>ASP.NET MVC TWAIN Demo</title>

    <script src="~/Scripts/Vintasoft.Shared.js" type="text/javascript"></script>
    <script src="~/Scripts/Vintasoft.Twain.js" type="text/javascript"></script>
</head>
<body>
    <div>

    </div>
</body>
</html>

    6. Клиентская сторона: Создайте разметку для отсканированного изображения на странице просмотра ASP.NET MVC.

      Создайте "<input type="image">" для отсканированного изображения.
      Откройте файл "Views\Default\Index.cshtml" и добавьте HTML код к файлу: 
      <!DOCTYPE html>

<html>
<head>
    <meta name="viewport" content="width=device-width" />
    <title>ASP.NET MVC TWAIN Demo</title>

    <script src="~/Scripts/Vintasoft.Shared.js" type="text/javascript"></script>
    <script src="~/Scripts/Vintasoft.Twain.js" type="text/javascript"></script>
</head>
<body>
    <div style="text-align:center">
        <h3>Preview of scanned image</h3>
        <input type="image" id="previewImage" alt="Preview of scanned image" style="border:1px solid black; width:350px; height:350px" />
        <br />
        <br />
        <a id="vintasoftWebTwainServiceInstallerLinkId" href="/Data/VintasoftWebTwainService-15.1.1.zip" hidden>Download installer of VintaSoft Web TWAIN service</a>
    </div>
</body>
</html>


    7. Клиентская сторона: Добавьте JavaScript код, который получает изображение от TWAIN сканера и отображает отсканированное изображение на странице.

      Откройте файл "Views\Default\Index.cshtml" и добавьте JavaScript код к файлу: 
      <script type="text/javascript">
    // acquire images from TWAIN scanner
    __acquireImageFromTwainScanner();



    /**
     * Acquires images from TWAIN scanner.
     */
    function __acquireImageFromTwainScanner() {
        // register the evaluation version of VintaSoft Web TWAIN service
        // please read how to get evaluation license in documentation: https://www.vintasoft.ru/docs/vstwain-dotnet-web/Licensing-Twain_Web-Evaluation.html
        Vintasoft.Twain.WebTwainGlobalSettingsJS.register('REG_USER', 'REG_URL', 'REG_CODE', 'EXPIRATION_DATE');

        // URL to the VintaSoft Web TWAIN service
        var serviceUrl = 'https://localhost:25329/api/VintasoftTwainApi';
        // a Web API controller that allows to work with TWAIN and SANE devices
        var twainService = new Vintasoft.Shared.WebServiceControllerJS(serviceUrl);

        // TWAIN device manager
        var deviceManager = new Vintasoft.Twain.WebTwainDeviceManagerJS(twainService);

        // the default settings of device manager
        var deviceManagerInitSetting = new Vintasoft.Twain.WebTwainDeviceManagerInitSettingsJS();

        try {
            // open device manager
            deviceManager.open(deviceManagerInitSetting);
        }
        catch (ex) {
            if (ex.toString().startsWith('NetworkError')) {
                document.getElementById('vintasoftWebTwainServiceInstallerLinkId').hidden = false;
                alert("VintaSoft Web TWAIN service is not found.\n\nPlease close this dialog, link 'Download installer of VintaSoft Web TWAIN service' will appear at the top of this page, click the link, download VintaSoft Web TWAIN Service, manually install the service on your computer, reload this web page in web browser (Firefox must be restarted) and try to scan images once again.");
            }
            else
                alert(ex);
            return;
        }

        var device = null;
        try {
            // get the default TWAIN device
            device = deviceManager.get_DefaultDevice();
            // open device without UI
            device.open(false);

            var acquireModalState;
            do {
                // do one step of modal image acquisition process
                var acquireModalResult = device.acquireModalSync();
                // get state of image acquisition
                acquireModalState = acquireModalResult.get_AcquireModalState().valueOf();

                switch (acquireModalState) {
                    case 2:   // image is acquired
                        // get acquired image
                        var acquiredImage = acquireModalResult.get_AcquiredImage();
                        // get image as Base64 string
                        var bitmapAsBase64String = acquiredImage.getAsBase64String();
                        // update image preview
                        var previewImageElement = document.getElementById('previewImage');
                        previewImageElement.src = bitmapAsBase64String;
                        break;
                    case 4:   // image scan is failed
                        alert(acquireModalResult.get_ErrorMessage());
                        break;
                    case 9:   // image scan is finished
                        break;
                }
            }
            while (acquireModalState !== 0);
        }
        catch (ex) {
            alert(ex);
        }
        finally {
            if (device != null) {
                // close the device
                device.close();
            }
            // close the device manager
            deviceManager.close();
        }
    }
</script>

    8. Запустите ASP.NET MVC 5 приложение и посмотрите результат.

      Запустите проект и посмотрите результат:


      Если VintaSoft Web TWAIN сервис не установлен на Вашем компьютере (Вы увидите сообщение об ошибке), Вам нужно выполнить следующие действия:
      • нажмите на ссылку "Загрузить инсталлятор VintaSoft Web TWAIN сервиса"
      • загрузите инсталлятор VintaSoft Web TWAIN сервиса на Ваш компьютер
      • установите VintaSoft Web TWAIN сервис на Ваш компьютер
      • обновите страницу приложения в браузере

     

     

    Копирайт © 2007-2025 ООО "ВинтаСофт". Все права защищены.

    Отправить отзыв