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


    Вот действия, которые необходимо выполнить:
    1. Создайте пустое ASP.NET WebForms приложение.

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

      Выберите шаблон "Empty" для ASP.NET Web приложения и сконфигурируйте проект для использования WebForms:

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

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

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

      • Добавьте папку "Scripts" к ASP.NET WebForms приложению.

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

      • Создайте Default веб-форму - файл "Default.aspx".
        • Нажмите правой кнопкой мыши на проект и выберите пункт "Add => WebForm" из контекстного меню:
        • Укажите "Default" в качестве имени веб-формы => созданная веб-форма откроется:
      • Добавьте ссылки на файлы Vintasoft JavaScript:

        Вот HTML код, который добавляет ссылки на файлы Vintasoft JavaScript:
        <%@ Page Language="C#" AutoEventWireup="true" CodeBehind="Default.aspx.cs" Inherits="WebApplication1.Default" %>
        
        <!DOCTYPE html>
        
        <html xmlns="http://www.w3.org/1999/xhtml">
        <head runat="server">
            <title>ASP.NET WebForms 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>
        </body>
        </html>
        
        
      • Добавьте HTML разметку (image-элемент, который будет отображать изображение, полученное от TWAIN сканера) к веб-виду:

        Вот код HTML разметки:
        <%@ Page Language="C#" AutoEventWireup="true" CodeBehind="Default.aspx.cs" Inherits="WebApplication1.Default" %>
        
        <!DOCTYPE html>
        
        <html xmlns="http://www.w3.org/1999/xhtml">
        <head runat="server">
            <title>ASP.NET WebForms 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.0.0.zip" hidden>Download installer of VintaSoft Web TWAIN service</a>
            </div>
        </body>
        </html>
        
        
      • Добавьте JavaScript код, который получает изображение от TWAIN сканера и отображает отсканированное изображение:

        Вот JavaScript код, который получает изображение от TWAIN сканера и отображает отсканированное изображение:
        <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.com/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>
        
        
    5. Запустите ASP.NET WebForms приложение и посмотрите результат.



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