Wstęp

Podpisy kodami kreskowymi są szeroko stosowane w cyfrowych obiegach dokumentów do kodowania ustrukturyzowanych danych, umożliwiając efektywne śledzenie, identyfikację i walidację. GroupDocs.Signature for .NET to kompleksowe rozwiązanie do podpisywania dokumentów, które umożliwia programistom integrację zaawansowanych funkcji podpisów z aplikacjami, w tym aktualizację istniejących podpisów kodami kreskowymi w dokumentach.

Ten samouczek koncentruje się na aktualizacji podpisów kodów kreskowych w dokumentach za pomocą GroupDocs.Signature dla platformy .NET. Niezależnie od tego, czy chcesz zmodyfikować położenie, rozmiar, czy zakodowane dane istniejących kodów kreskowych, ten przewodnik przeprowadzi Cię przez ten proces za pomocą przejrzystych przykładów kodu i wyjaśnień.

Wymagania wstępne

Przed wdrożeniem aktualizacji podpisów kodów kreskowych za pomocą GroupDocs.Signature dla .NET należy upewnić się, że spełnione są następujące wymagania wstępne:

  1. Środowisko programistyczne: działające środowisko programistyczne .NET, takie jak Visual Studio 2017 lub nowsze.
  2. Biblioteka GroupDocs.Signature: Biblioteka GroupDocs.Signature dla platformy .NET, którą można pobrać ze strony strona pobierania.
  3. Podstawowa wiedza z zakresu języka C#: Znajomość koncepcji programowania w języku C#.
  4. Przykładowe dokumenty: Dokument(y) zawierające podpisy z kodem kreskowym, które chcesz zaktualizować.

Importuj przestrzenie nazw

Zacznij od zaimportowania niezbędnych przestrzeni nazw, aby uzyskać dostęp do funkcjonalności GroupDocs.Signature:

using System;
using System.Collections.Generic;
using System.IO;
using GroupDocs.Signature;
using GroupDocs.Signature.Domain;
using GroupDocs.Signature.Options;

Podzielmy teraz proces aktualizacji podpisów kodów kreskowych na łatwiejsze do opanowania kroki:

Krok 1: Skonfiguruj ścieżki dokumentów

Najpierw zdefiniuj ścieżki do dokumentu źródłowego i miejsce, w którym zostanie zapisany zaktualizowany dokument:

// Ścieżka do dokumentu źródłowego z podpisami kodów kreskowych
string filePath = "sample_multiple_signatures.docx";

// Pobierz nazwę pliku wyjściowego
string fileName = Path.GetFileName(filePath);

// Zdefiniuj katalog wyjściowy i ścieżkę pliku
string outputDirectory = Path.Combine("Your Document Directory", "UpdateBarcode");
string outputFilePath = Path.Combine(outputDirectory, fileName);

// Upewnij się, że katalog wyjściowy istnieje
Directory.CreateDirectory(outputDirectory);

Krok 2: Skopiuj dokument źródłowy

Ponieważ operacja aktualizacji modyfikuje dokument bezpośrednio, utwórz kopię oryginalnego dokumentu, aby go zachować:

// Utwórz kopię oryginalnego dokumentu
File.Copy(filePath, outputFilePath, true);

Krok 3: Zainicjuj instancję podpisu

Utwórz instancję Signature klasa do pracy z dokumentem:

// Zainicjuj instancję podpisu ze ścieżką pliku wyjściowego
using (Signature signature = new Signature(outputFilePath))
{
    // Tutaj będą wykonywane operacje podpisu
}

Krok 4: Skonfiguruj opcje wyszukiwania kodów kreskowych

Skonfiguruj opcje wyszukiwania, aby znaleźć istniejące podpisy z kodem kreskowym w dokumencie:

// Konfigurowanie opcji wyszukiwania podpisów kodów kreskowych
BarcodeSearchOptions options = new BarcodeSearchOptions()
{
    // Możesz filtrować według zawartości tekstowej
    Text = "12345",
    MatchType = TextMatchType.Contains
    
    // Odkomentuj, aby wyszukać na wszystkich stronach
    // Wszystkie strony = prawda
};

Krok 5: Wyszukaj podpisy kodów kreskowych

Aby znaleźć podpisy z kodem kreskowym w dokumencie, skorzystaj z skonfigurowanych opcji wyszukiwania:

// Wyszukaj podpisy kodów kreskowych
List<BarcodeSignature> signatures = signature.Search<BarcodeSignature>(options);

Krok 6: Zaktualizuj właściwości podpisu kodu kreskowego

Jeśli zostaną znalezione podpisy w postaci kodów kreskowych, zaktualizuj ich właściwości w razie potrzeby:

// Sprawdź, czy znaleziono podpisy
if (signatures.Count > 0)
{
    // Zdobądź pierwszy podpis kodem kreskowym
    BarcodeSignature barcodeSignature = signatures[0];
    
    // Aktualizuj pozycję
    barcodeSignature.Left = 100;
    barcodeSignature.Top = 100;
    
    // Rozmiar aktualizacji
    barcodeSignature.Width = 400;
    barcodeSignature.Height = 100;
    
    // Zastosuj aktualizacje
    bool result = signature.Update(barcodeSignature);
    
    // Sprawdź wynik
    if (result)
    {
        Console.WriteLine($"Signature with Barcode '{barcodeSignature.Text}' and encode type '{barcodeSignature.EncodeType.TypeName}' was updated in the document ['{fileName}'].");
    }
    else
    {
        Console.WriteLine($"Signature was not updated in the document! Signature with Barcode '{barcodeSignature.Text}' and encode type '{barcodeSignature.EncodeType.TypeName}' was not found!");
    }
}
else
{
    Console.WriteLine("No barcode signatures found in the document.");
}

Pełny przykład

Oto kompletny, funkcjonalny przykład pokazujący, jak zaktualizować podpis w postaci kodu kreskowego w dokumencie:

using System;
using System.Collections.Generic;
using System.IO;
using GroupDocs.Signature;
using GroupDocs.Signature.Domain;
using GroupDocs.Signature.Options;

namespace UpdateBarcodeSignatureExample
{
    class Program
    {
        static void Main(string[] args)
        {
            // Ścieżka dokumentu
            string filePath = "sample_multiple_signatures.docx";
            
            // Zdefiniuj ścieżkę wyjściową
            string fileName = Path.GetFileName(filePath);
            string outputDirectory = Path.Combine(Environment.CurrentDirectory, "UpdateBarcode");
            string outputFilePath = Path.Combine(outputDirectory, fileName);
            
            // Upewnij się, że katalog wyjściowy istnieje
            Directory.CreateDirectory(outputDirectory);
            
            // Utwórz kopię oryginalnego dokumentu
            File.Copy(filePath, outputFilePath, true);
            
            // Zainicjuj instancję podpisu
            using (Signature signature = new Signature(outputFilePath))
            {
                // Konfiguruj opcje wyszukiwania
                BarcodeSearchOptions options = new BarcodeSearchOptions
                {
                    Text = "12345",
                    MatchType = TextMatchType.Contains
                };
                
                // Wyszukaj podpisy kodów kreskowych
                List<BarcodeSignature> signatures = signature.Search<BarcodeSignature>(options);
                
                // Sprawdź, czy znaleziono podpisy
                if (signatures.Count > 0)
                {
                    // Zdobądź pierwszy podpis
                    BarcodeSignature barcodeSignature = signatures[0];
                    
                    // Zaktualizuj pozycję i rozmiar
                    barcodeSignature.Left = 100;
                    barcodeSignature.Top = 100;
                    barcodeSignature.Width = 400;
                    barcodeSignature.Height = 100;
                    
                    // Zastosuj aktualizacje
                    bool result = signature.Update(barcodeSignature);
                    
                    // Sprawdź wynik
                    if (result)
                    {
                        Console.WriteLine($"Barcode signature was successfully updated in document '{fileName}'.");
                        Console.WriteLine($"Barcode text: {barcodeSignature.Text}");
                        Console.WriteLine($"Encode type: {barcodeSignature.EncodeType.TypeName}");
                        Console.WriteLine($"New position: {barcodeSignature.Left}x{barcodeSignature.Top}");
                        Console.WriteLine($"New size: {barcodeSignature.Width}x{barcodeSignature.Height}");
                        Console.WriteLine($"Output file path: {outputFilePath}");
                    }
                    else
                    {
                        Console.WriteLine("Failed to update barcode signature!");
                    }
                }
                else
                {
                    Console.WriteLine("No barcode signatures found in the document.");
                }
            }
            
            Console.WriteLine("\nPress any key to exit...");
            Console.ReadKey();
        }
    }
}

Zaawansowana personalizacja podpisu kodem kreskowym

GroupDocs.Signature udostępnia dodatkowe opcje dostosowywania podpisów kodów kreskowych wykraczające poza podstawowe położenie i rozmiar:

Dostosowywanie właściwości wyglądu

Dostosuj wygląd wizualny kodu kreskowego:

// Ustaw kolor pierwszego planu (kolor kodu kreskowego)
barcodeSignature.ForeColor = System.Drawing.Color.Blue;

// Ustaw kolor tła
barcodeSignature.BackgroundColor = System.Drawing.Color.LightYellow;

// Dostosuj przezroczystość
barcodeSignature.Opacity = 0.8;

Dodawanie obramowań

Ulepsz kod kreskowy za pomocą niestandardowych obramowań:

barcodeSignature.Border.Color = System.Drawing.Color.Red;
barcodeSignature.Border.DashStyle = System.Drawing.Drawing2D.DashStyle.Dash;
barcodeSignature.Border.Weight = 2;
barcodeSignature.Border.Visible = true;

Obrót kodu kreskowego

Obróć podpis kodem kreskowym pod określonym kątem:

barcodeSignature.Angle = 30; // Obróć o 30 stopni

Wniosek

GroupDocs.Signature for .NET to wydajne i elastyczne rozwiązanie do aktualizacji podpisów kodów kreskowych w dokumentach. Postępując zgodnie z instrukcjami opisanymi w tym samouczku, programiści mogą sprawnie wdrożyć funkcję aktualizacji podpisów kodów kreskowych w swoich aplikacjach .NET, usprawniając zarządzanie dokumentami i automatyzację.

Dzięki kompleksowemu zestawowi funkcji i intuicyjnemu interfejsowi API GroupDocs.Signature umożliwia deweloperom tworzenie zaawansowanych rozwiązań do podpisywania dokumentów, które spełniają wymagania nowoczesnych aplikacji biznesowych, a jednocześnie zapewniają integralność i dostępność dokumentów.

Najczęściej zadawane pytania

Czy mogę aktualizować wiele podpisów kodów kreskowych w jednym dokumencie?

Tak, GroupDocs.Signature pozwala na aktualizację wielu podpisów kodów kreskowych w tym samym dokumencie. Po wyszukaniu podpisów możesz przejrzeć listę wyników i zaktualizować każdy podpis kodu kreskowego osobno.

Czy GroupDocs.Signature obsługuje różne formaty kodów kreskowych?

Tak, GroupDocs.Signature obsługuje szeroką gamę formatów kodów kreskowych, w tym kody liniowe (Code 128, Code 39, EAN, UPC itp.) i kody 2D (QR Code, Data Matrix, PDF417 itp.).

Czy jest dostępna wersja próbna GroupDocs.Signature dla .NET?

Tak, możesz pobrać bezpłatną wersję próbną ze strony Strona internetowa GroupDocs aby ocenić możliwości biblioteki przed dokonaniem zakupu.

Czy podczas aktualizacji mogę konwertować jeden typ kodu kreskowego na inny?

Bezpośrednia konwersja między typami kodów kreskowych nie jest obsługiwana podczas aktualizacji. Można to jednak osiągnąć, usuwając istniejący kod kreskowy i dodając nowy w żądanym formacie.

Czy aktualizacja kodu kreskowego wpływa na możliwość jego skanowania?

Podczas aktualizacji właściwości kodu kreskowego, takich jak rozmiar i położenie, GroupDocs.Signature zachowuje integralność skanowania kodu kreskowego. Jednak wyjątkowo małe rozmiary lub znaczne kąty obrotu mogą wpływać na wydajność skanowania w niektórych czytnikach.

Gdzie mogę znaleźć dodatkowe wsparcie dla GroupDocs.Signature dla .NET?

Kompleksowe wsparcie możesz uzyskać, korzystając z następujących źródeł: