Wstęp

Dokumenty tekstowe należą do najpopularniejszych typów plików wykorzystywanych w biznesie, edukacji i komunikacji osobistej. Zapewnienie autentyczności, śledzenie pochodzenia i zachowanie integralności tych dokumentów ma kluczowe znaczenie w wielu środowiskach zawodowych. Jednym ze skutecznych sposobów zwiększenia bezpieczeństwa i identyfikowalności dokumentów jest osadzanie podpisów metadanych.

Ten kompleksowy samouczek przeprowadzi Cię przez proces podpisywania dokumentów Worda metadanymi za pomocą GroupDocs.Signature dla platformy .NET. Dodając podpisy metadanych, możesz osadzać cenne informacje, takie jak dane autora, znaczniki czasu utworzenia, identyfikatory dokumentów i inne niestandardowe właściwości, bezpośrednio w strukturze pliku dokumentu.

Wymagania wstępne

Przed przystąpieniem do pracy z tym samouczkiem upewnij się, że posiadasz następujące elementy:

GroupDocs.Signature dla .NET - Pobierz i zainstaluj bibliotekę
Środowisko programistyczne — Visual Studio lub inne środowisko IDE zgodne z platformą .NET
Dokument Word – przykładowy plik dokumentu (DOCX, DOC itp.)
Podstawowa wiedza z zakresu języka C# – znajomość języka programowania C#

Importuj przestrzenie nazw

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

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

Krok 1: Skonfiguruj ścieżki plików

Zdefiniuj ścieżki do źródłowego dokumentu Word i miejsce, w którym ma zostać zapisany podpisany dokument wyjściowy:

// Podaj ścieżkę do dokumentu Word
string filePath = "sample.docx";

// Zdefiniuj katalog wyjściowy i nazwę pliku podpisanego dokumentu
string outputDirectory = "Your Document Directory";
string outputFilePath = Path.Combine(outputDirectory, "SignWordProcessingWithMetadata", "SignedWithMetadata.docx");

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

Krok 2: Zainicjuj obiekt podpisu

Utwórz wystąpienie klasy Signature w dokumencie źródłowym programu Word:

using (Signature signature = new Signature(filePath))
{
    // Reszta kodu będzie tutaj
}

Krok 3: Utwórz i skonfiguruj podpisy metadanych

Następnie zdefiniuj opcje metadanych i dodaj różne typy podpisów metadanych:

// Utwórz obiekt opcji metadanych
MetadataSignOptions options = new MetadataSignOptions();

// Dodawaj różne typy metadanych za pomocą płynnego interfejsu
options
    .Add(new WordProcessingMetadataSignature("Author", "Mr.Sherlock Holmes")) // Wartość ciągu
    .Add(new WordProcessingMetadataSignature("CreatedOn", DateTime.Now))      // Wartość daty i godziny
    .Add(new WordProcessingMetadataSignature("DocumentId", 123456))           // Wartość całkowita
    .Add(new WordProcessingMetadataSignature("SignatureId", 123.456D))        // Podwójna wartość
    .Add(new WordProcessingMetadataSignature("Amount", 123.456M))             // Wartość dziesiętna
    .Add(new WordProcessingMetadataSignature("Total", 123.456F));             // Wartość zmiennoprzecinkowa

Krok 4: Podpisz dokument metadanymi

Zastosuj podpisy metadanych do dokumentu Word i zapisz wynik:

// Podpisz dokument i zapisz w ścieżce pliku wyjściowego
SignResult result = signature.Sign(outputFilePath, options);

// Wyświetl komunikat o powodzeniu
Console.WriteLine($"\nSource document signed successfully with {result.Succeeded.Count} metadata signature(s).");
Console.WriteLine($"Signed document saved at: {outputFilePath}");

Pełny przykład

Oto kompletny przykład kodu łączący wszystkie kroki:

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

namespace SignWordProcessingWithMetadataExample
{
    class Program
    {
        static void Main(string[] args)
        {
            // Określ ścieżki plików
            string filePath = "sample.docx";
            string outputFilePath = Path.Combine("Your Document Directory", "SignWordProcessingWithMetadata", "SignedWithMetadata.docx");
            
            // Upewnij się, że katalog wyjściowy istnieje
            Directory.CreateDirectory(Path.GetDirectoryName(outputFilePath));

            // Podpisz dokument Worda metadanymi
            using (Signature signature = new Signature(filePath))
            {
                // Utwórz obiekt opcji metadanych
                MetadataSignOptions options = new MetadataSignOptions();
                
                // Dodaj różne typy podpisów metadanych
                options
                    .Add(new WordProcessingMetadataSignature("Author", "Mr.Sherlock Holmes")) // Wartość ciągu
                    .Add(new WordProcessingMetadataSignature("CreatedOn", DateTime.Now))      // Wartość daty i godziny
                    .Add(new WordProcessingMetadataSignature("DocumentId", 123456))           // Wartość całkowita
                    .Add(new WordProcessingMetadataSignature("SignatureId", 123.456D))        // Podwójna wartość
                    .Add(new WordProcessingMetadataSignature("Amount", 123.456M))             // Wartość dziesiętna
                    .Add(new WordProcessingMetadataSignature("Total", 123.456F));             // Wartość zmiennoprzecinkowa
                
                // Podpisz dokument i zapisz do pliku
                SignResult result = signature.Sign(outputFilePath, options);
                
                // Wyświetl wyniki
                Console.WriteLine($"\nSource document signed successfully with {result.Succeeded.Count} signature(s).");
                Console.WriteLine($"File saved at {outputFilePath}.");
            }
        }
    }
}

Zaawansowane techniki metadanych dokumentów Word

Praca z niestandardowymi i wbudowanymi właściwościami dokumentu

Dokumenty Word mają zarówno wbudowane, jak i niestandardowe właściwości, do których można uzyskać dostęp za pośrednictwem panelu właściwości dokumentu. GroupDocs.Signature umożliwia pracę z:

// Dodaj wbudowane właściwości
options
    .Add(new WordProcessingMetadataSignature("Company", "Sherlock Holmes Consulting"))
    .Add(new WordProcessingMetadataSignature("Category", "Legal Document"))
    .Add(new WordProcessingMetadataSignature("Keywords", "contract,agreement,legal"))
    .Add(new WordProcessingMetadataSignature("Comments", "This document is confidential"))
    .Add(new WordProcessingMetadataSignature("Manager", "John Watson"));

// Dodaj właściwości niestandardowe
options.Add(new WordProcessingMetadataSignature("Department", "Legal"));
options.Add(new WordProcessingMetadataSignature("SecurityLevel", "Confidential"));

Wyszukiwanie metadanych w podpisanych dokumentach Word

Po podpisaniu możesz chcieć zweryfikować lub wyodrębnić metadane:

// Utwórz opcje wyszukiwania metadanych
MetadataSearchOptions searchOptions = new MetadataSearchOptions();

// Wyszukaj podpisy metadanych
SearchResult searchResult = signature.Search(searchOptions);

// Wyświetl znalezione podpisy
Console.WriteLine($"Found {searchResult.Signatures.Count} metadata signatures:");
foreach (var foundSignature in searchResult.Signatures)
{
    MetadataSignature metadataSignature = foundSignature as MetadataSignature;
    if (metadataSignature != null)
    {
        Console.WriteLine($"- {metadataSignature.Name}: {metadataSignature.Value} ({metadataSignature.Value.GetType().Name})");
    }
}

Praca ze zmiennymi dokumentu

Dokumenty Word obsługują również zmienne dokumentu, które stanowią inną formę metadanych:

// Dodaj zmienne dokumentu
options.Add(new WordProcessingMetadataSignature("DocVariable1", "Custom Value 1", true));
options.Add(new WordProcessingMetadataSignature("DocVariable2", DateTime.Now, true));

Wniosek

W tym kompleksowym samouczku dowiesz się, jak podpisywać dokumenty programu Word metadanymi za pomocą GroupDocs.Signature dla platformy .NET. Osadzanie metadanych w dokumentach programu Word zwiększa identyfikowalność dokumentów, zapewnia cenny kontekst i pomaga w ustaleniu autentyczności.

Podpisy metadanych w dokumentach Word są szczególnie przydatne w środowiskach biznesowych i prawnych, gdzie istotne są pochodzenie dokumentu, jego autorstwo i śledzenie wersji. Osadzone metadane mogą zawierać informacje o autorze, czasie utworzenia, identyfikatorach dokumentów i właściwościach niestandardowych istotnych dla potrzeb organizacji.

Dzięki wdrożeniu podpisów metadanych za pomocą GroupDocs.Signature możesz mieć pewność, że Twoje dokumenty Word zachowają integralność i będą dostarczać weryfikowalnych informacji przez cały cykl ich życia.

Najczęściej zadawane pytania

Czy mogę dodać metadane do dokumentów Word, które mają już zdefiniowane pewne właściwości?

Tak, możesz dodawać nowe metadane lub aktualizować istniejące metadane w dokumentach Word. GroupDocs.Signature zajmie się integracją, dodając nowe właściwości lub aktualizując istniejące o tych samych nazwach.

Które formaty programów do przetwarzania tekstu są obsługiwane w przypadku podpisywania metadanych?

GroupDocs.Signature dla .NET obsługuje podpisywanie metadanych dla różnych formatów przetwarzania tekstu, w tym DOCX, DOC, RTF, ODT i innych. Pełną listę można znaleźć w dokumentacja.

Czy podpisy metadanych w dokumentach Word są widoczne dla czytelników?

Podpisy metadanych nie są widoczne w samej treści dokumentu. Można je jednak wyświetlić w panelu właściwości dokumentu w programie Microsoft Word lub innych zgodnych aplikacjach.

Czy mogę programowo sprawdzić, czy dokument Word został zmodyfikowany po dodaniu metadanych?

Tak, GroupDocs.Signature zapewnia funkcje weryfikacji, które mogą pomóc wykryć, czy dokument został zmodyfikowany po podpisaniu, w tym czy wprowadzono zmiany w metadanych.

Czy można usunąć metadane z dokumentu Word?

Tak, GroupDocs.Signature oferuje opcje usuwania podpisów metadanych z dokumentów, jeśli jest to konieczne. Może to być przydatne do czyszczenia poufnych informacji przed udostępnieniem dokumentów na zewnątrz.