VintaSoft Barcode .NET SDK 16.1: Документация для Веб разработчика
В этом разделе
Генерация изображения штрих-кода в приложении "React.js и ASP.NET Core"
В этом разделе
Данное руководство демонстрирует, как создать пустое приложение "React.js и ASP.NET Core" в Visual Studio .NET 2026 и сгенерировать изображение штрих-кода в приложении "React.js и ASP.NET Core".

Вот шаги, которые необходимо выполнить:
  1. Создайте пустое приложение "React.js и ASP.NET Core".

    Откройте Visual Studio .NET 2026 и создайте новый проект типа "приложение React.js и ASP.NET Core":

    Настройте проект для использования .NET 10.0:

  2. Проект "ReactApp1.Server": Добавьте ссылки на nuget-пакеты Vintasoft в приложение ASP.NET Core.

    Добавьте ссылки на nuget-пакеты Vintasoft.Barcode , Vintasoft.Barcode.SkiaSharp и Vintasoft.Barcode.AspNetCore.ApiControllers в проект "ReactApp1.Server".
    Комментарий: Ссылка на nuget-пакет Vintasoft.Barcode.SkiaSharp необходима только в том случае, если SDK должен отображать текстовое значение штрих-кода на изображении штрих-кода. Вместо nuget-пакета Vintasoft.Barcode.SkiaSharp можно использовать nuget-пакет Vintasoft.Barcode.ImageSharp или Vintasoft.Barcode.Gdi .

  3. Проект "ReactApp1.Server": Добавьте контроллер Web API, позволяющий генерировать изображение штрих-кода.

    • Нажмите правую кнопку мыши на папке "Controllers" и выберите "Add => Controller..." в контекстном меню
    • Выберите пустой шаблон API-контроллера, задайте имя контроллера как "MyVintasoftBarcodeApiController" и нажмите кнопку "Добавить".
    • Укажите, что класс MyVintasoftBarcodeApiController является производным от класса Vintasoft.Barcode.AspNetCore.ApiControllers.VintasoftBarcodeApiController.

      Вот исходный код класса MyVintasoftBarcodeApiController:
      using Vintasoft.Barcode.AspNetCore.ApiControllers;
      
      namespace WebApplication1.Controllers
      {
          public class MyVintasoftBarcodeApiController : VintasoftBarcodeApiController
          {
      
              public MyVintasoftBarcodeApiController(IWebHostEnvironment hostingEnvironment)
                  : base(hostingEnvironment)
              {
              }
      
          }
      }
      
      
  4. Проект "ReactApp1.Server": Удалите не нужные файлы.

    Удалите файлы "ReactApp1.Server.http", "WeatherForecast.cs" и "Controllers\WeatherForecastController.cs" в проекте "ReactApp1.Server" - контроллер Web API WeatherForecast в этом примере не нужен.
  5. Проект "reactapp1.client": Скомпилируйте решение для восстановления зависимостей TypeScript в проекте "reactapp1.client".

  6. Проект "reactapp1.client": Добавьте файлы JavaScript в приложение ASP.NET Core.

    • Скопируйте JavaScript-файл "Vintasoft.Shared.js" с Github в проекте "reactapp1.client".
      Скопируйте Файл JavaScript "Vintasoft.Barcode.js" с Github в проекте "reactapp1.client".

    • Добавьте ссылки на файлы JavaScript Vintasoft в заголовок файла "index.html" в проекте "reactapp1.client":
      <!doctype html>
      <html lang="en">
      <head>
          <meta charset="UTF-8" />
          <link rel="icon" type="image/svg+xml" href="/vite.svg" />
          <meta name="viewport" content="width=device-width, initial-scale=1.0" />
          <title>reactapp1.client</title>
      
          <script src="Vintasoft.Shared.js" type="text/javascript"></script>
          <script src="Vintasoft.Barcode.js" type="text/javascript"></script>
      </head>
      <body>
          <div id="root"></div>
          <script type="module" src="/src/main.jsx"></script>
      </body>
      </html>
      
      

  7. Проект "reactapp1.client": Создайте компонент React.js, который генерирует изображение штрих-кода и отображает его.

    • Откройте файл "src\App.jsx" в проекте "reactapp1.client", очистите файл, добавьте код JavaScript в файл "App.jsx" (функция "App" генерирует разметку страницы и запускает генерацию изображения штрих-кода, функция "__generateBarcode" генерирует изображение штрих-кода):


      Вот код JavaScript из файла App.jsx:
      import './App.css'
      
      function App() {
          return (
              <>
                  <div>
                      <h1>Angular Barcode Generator Demo</h1>
      
                      <img id="barcodeImage" src="" />
                  </div>
                  <script>{setTimeout(__generateBarcode, 10)}</script>
              </>
          )
      }
      
      /**
       * Generates barcode image.
       */
      function __generateBarcode() {
          // generate image of QR barcode with value "12345"
          __generate2dBarcodeImage("QR", "12345");
      }
      
      /**
       * Generates 1D barcode image.
       * @param barcodeType Barcode type.
       * @param barcodeValue Barcode value.
       */
      function __generate1dBarcodeImage(barcodeType, barcodeValue) {
          try {
              // declare reference to the Vintasoft namespace
              var Vintasoft = window.Vintasoft;
      
              if (Vintasoft.Shared.WebImagingEnviromentJS.get_SessionId() == null)
                  // set the session identifier
                  Vintasoft.Shared.WebImagingEnviromentJS.set_SessionId("SessionID");
      
              // create web service that allows to generate barcode
              var barcodeService = new Vintasoft.Shared.WebServiceControllerJS("vintasoft/api/MyVintasoftBarcodeApi");
      
              // create the barcode writer
              var barcodeWriter = new Vintasoft.Barcode.WebBarcodeWriterJS(barcodeService);
      
              // create the barcode writer settings for generating 2D barcode
              var barcodeWriterSettings = new Vintasoft.Barcode.Web1DBarcodeWriterSettingsJS();
              // specify that barcode writer must generate QR barcode image
              barcodeWriterSettings.set_BarcodeType(new Vintasoft.Barcode.WebBarcodeTypeEnumJS(barcodeType));
              // specify the QR barcode value
              barcodeWriterSettings.set_Value(barcodeValue);
      
              // specify settings for barcode writer
              barcodeWriter.set_Settings(barcodeWriterSettings);
      
              // send an asynchronous request for getting barcode image as Base64 string
              barcodeWriter.getBarcodeAsBase64Image(__writeBarcode_success, __writeBarcode_failed);
          }
          catch (ex) {
              alert("Error: " + ex);
          }
      }
      
      /**
       * Generates 2D barcode image.
       * @param barcodeType Barcode type.
       * @param barcodeValue Barcode value.
      */
      function __generate2dBarcodeImage(barcodeType, barcodeValue) {
          try {
              // declare reference to the Vintasoft namespace
              var Vintasoft = window.Vintasoft;
      
              if (Vintasoft.Shared.WebImagingEnviromentJS.get_SessionId() == null)
                  // set the session identifier
                  Vintasoft.Shared.WebImagingEnviromentJS.set_SessionId("SessionID");
      
              // create web service that allows to generate barcode
              var barcodeService = new Vintasoft.Shared.WebServiceControllerJS("vintasoft/api/MyVintasoftBarcodeApi");
      
              // create the barcode writer
              var barcodeWriter = new Vintasoft.Barcode.WebBarcodeWriterJS(barcodeService);
      
              // create the barcode writer settings for generating 2D barcode
              var barcodeWriterSettings = new Vintasoft.Barcode.Web2DBarcodeWriterSettingsJS();
              // specify that barcode writer must generate QR barcode image
              barcodeWriterSettings.set_BarcodeType(new Vintasoft.Barcode.WebBarcodeTypeEnumJS(barcodeType));
              // specify the QR barcode value
              barcodeWriterSettings.set_Value(barcodeValue);
      
              // specify settings for barcode writer
              barcodeWriter.set_Settings(barcodeWriterSettings);
      
              // send an asynchronous request for getting barcode image as Base64 string
              barcodeWriter.getBarcodeAsBase64Image(__writeBarcode_success, __writeBarcode_failed);
          }
          catch (ex) {
              alert("Error: " + ex);
          }
      }
      
      /**
       * Barcode is generated successfully.
       * @param data Object that stores response from barcode service.
       */
      function __writeBarcode_success(data) {
          if (data.success) {
              var barcodeImage = data.barcodeImage;
              var barcodeImageElement = document.getElementById("barcodeImage");
              barcodeImageElement.src = barcodeImage;
          }
          else {
              alert(data.errorMessage);
          }
      }
      
      /**
       * Barcode generation is failed.
       * @param data Object with information about error.
       */
      function __writeBarcode_failed(data) {
          // show information about error
          alert(data.errorMessage);
      }
      
      export default App
      
      

    • Откройте файл "Properties\launchSettings.json" в проекте "ReactApp1.Server" и получите URL веб-сервиса из параметра "applicationUrl" раздела "profiles\https" - в этом примере URL - "https://localhost:7109":


      Откройте файл "vite.config.js" в проекте "reactapp1.client" и укажите, что приложение React.js может иметь доступ к веб-сервису в проекте "ReactApp1.Server" (добавьте раздел "server" в объект "defineConfig"):
      import { defineConfig } from 'vite'
      import react from '@vitejs/plugin-react'
      
      const target = 'https://localhost:7109';
      
      // https://vite.dev/config/
      export default defineConfig({
          plugins: [react()],
          server: {
              proxy: {
                  '^/vintasoft/api/': {
                      target,
                      secure: false
                  }
              },
              port: 7109
          }
      })
      
      

  8. Запустите приложение "React.js with ASP.NET Core" и посмотрите результат.