Wstęp

Arkusze kalkulacyjne Excela często zawierają krytyczne dane biznesowe, informacje finansowe i ważne obliczenia. Zapewnienie ich autentyczności, śledzenie ich pochodzenia i ochrona integralności są kluczowe w wielu środowiskach zawodowych. Jednym ze skutecznych sposobów zwiększenia bezpieczeństwa i identyfikowalności arkuszy kalkulacyjnych jest osadzanie podpisów metadanych.

Ten kompleksowy samouczek przeprowadzi Cię przez proces podpisywania arkuszy kalkulacyjnych Excela 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 arkusza kalkulacyjnego.

Wymagania wstępne

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

  1. GroupDocs.Signature dla .NET - Pobierz i zainstaluj bibliotekę
  2. Środowisko programistyczne — Visual Studio lub inne środowisko IDE zgodne z platformą .NET
  3. Arkusz kalkulacyjny Excel — przykładowy plik arkusza kalkulacyjnego (XLSX, XLS itp.)
  4. 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 arkusza kalkulacyjnego i miejsce, w którym mają zostać zapisane podpisane dane wyjściowe:

// Podaj ścieżkę do pliku Excel
string filePath = "sample.xlsx";

// Zdefiniuj katalog wyjściowy i nazwę pliku dla podpisanego arkusza kalkulacyjnego
string outputDirectory = "Your Document Directory";
string outputFilePath = Path.Combine(outputDirectory, "SignSpreadsheetWithMetadata", "SignedWithMetadata.xlsx");

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

Krok 2: Zainicjuj obiekt podpisu

Utwórz wystąpienie klasy Signature przy użyciu pliku źródłowego arkusza kalkulacyjnego:

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 utwórz tablicę podpisów metadanych arkusza kalkulacyjnego:

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

// Utwórz tablicę podpisów metadanych arkusza kalkulacyjnego z różnymi typami danych
SpreadsheetMetadataSignature[] signatures = new SpreadsheetMetadataSignature[]
{
    new SpreadsheetMetadataSignature("Author", "Mr.Sherlock Holmes"), // Wartość ciągu
    new SpreadsheetMetadataSignature("CreatedOn", DateTime.Now),      // Wartość daty i godziny
    new SpreadsheetMetadataSignature("DocumentId", 123456),           // Wartość całkowita
    new SpreadsheetMetadataSignature("SignatureId", 123.456D),        // Podwójna wartość
    new SpreadsheetMetadataSignature("Amount", 123.456M),             // Wartość dziesiętna
    new SpreadsheetMetadataSignature("Total", 123.456F)               // Wartość zmiennoprzecinkowa
};

// Dodaj kolekcję podpisów do opcji
options.Signatures.AddRange(signatures);

Krok 4: Podpisz arkusz kalkulacyjny metadanymi

Zastosuj podpisy metadanych do arkusza kalkulacyjnego 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 spreadsheet signed successfully with {result.Succeeded.Count} metadata signature(s).");
Console.WriteLine($"Signed spreadsheet 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 SignSpreadsheetWithMetadataExample
{
    class Program
    {
        static void Main(string[] args)
        {
            // Określ ścieżki plików
            string filePath = "sample.xlsx";
            string outputFilePath = Path.Combine("Your Document Directory", "SignSpreadsheetWithMetadata", "SignedWithMetadata.xlsx");
            
            // Upewnij się, że katalog wyjściowy istnieje
            Directory.CreateDirectory(Path.GetDirectoryName(outputFilePath));

            // Podpisz arkusz kalkulacyjny metadanymi
            using (Signature signature = new Signature(filePath))
            {
                // Utwórz obiekt opcji metadanych
                MetadataSignOptions options = new MetadataSignOptions();
                
                // Utwórz tablicę podpisów metadanych arkusza kalkulacyjnego z różnymi typami danych
                SpreadsheetMetadataSignature[] signatures = new SpreadsheetMetadataSignature[]
                {
                    new SpreadsheetMetadataSignature("Author", "Mr.Sherlock Holmes"), // Wartość ciągu
                    new SpreadsheetMetadataSignature("CreatedOn", DateTime.Now),      // Wartość daty i godziny
                    new SpreadsheetMetadataSignature("DocumentId", 123456),           // Wartość całkowita
                    new SpreadsheetMetadataSignature("SignatureId", 123.456D),        // Podwójna wartość
                    new SpreadsheetMetadataSignature("Amount", 123.456M),             // Wartość dziesiętna
                    new SpreadsheetMetadataSignature("Total", 123.456F)               // Wartość zmiennoprzecinkowa
                };
                
                // Dodaj kolekcję podpisów do opcji
                options.Signatures.AddRange(signatures);
                
                // Podpisz dokument i zapisz do pliku
                SignResult result = signature.Sign(outputFilePath, options);
                
                // Wyświetl wyniki
                Console.WriteLine($"\nSource spreadsheet signed successfully with {result.Succeeded.Count} signature(s).");
                Console.WriteLine($"File saved at {outputFilePath}.");
            }
        }
    }
}

Zaawansowane techniki metadanych arkusza kalkulacyjnego

Praca z niestandardowymi i wbudowanymi właściwościami arkusza kalkulacyjnego

Arkusze kalkulacyjne Excela mają zarówno wbudowane, jak i niestandardowe właściwości, do których można uzyskać dostęp za pośrednictwem okna dialogowego właściwości pliku. GroupDocs.Signature umożliwia pracę z:

// Dodaj wbudowane właściwości
signatures = new SpreadsheetMetadataSignature[]
{
    new SpreadsheetMetadataSignature("Company", "Sherlock Holmes Consulting"),
    new SpreadsheetMetadataSignature("Category", "Financial"),
    new SpreadsheetMetadataSignature("Keywords", "budget,forecast,analysis"),
    new SpreadsheetMetadataSignature("Comments", "This spreadsheet contains confidential information"),
    new SpreadsheetMetadataSignature("Manager", "John Watson")
};
options.Signatures.AddRange(signatures);

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

Wyszukiwanie metadanych w podpisanych arkuszach kalkulacyjnych

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})");
    }
}

Aktualizowanie istniejących metadanych

Możesz aktualizować istniejące metadane w arkuszach kalkulacyjnych, używając tych samych nazw właściwości:

// Zaktualizuj istniejące metadane
options.Signatures.Add(new SpreadsheetMetadataSignature("Author", "Updated Author Name"));

Wniosek

W tym kompleksowym samouczku dowiesz się, jak podpisywać arkusze kalkulacyjne Excela metadanymi za pomocą GroupDocs.Signature dla platformy .NET. Osadzanie metadanych w plikach arkuszy kalkulacyjnych usprawnia śledzenie dokumentów, zapewnia cenny kontekst i pomaga w ustaleniu autentyczności.

Podpisy metadanych w arkuszach kalkulacyjnych są szczególnie przydatne w środowiskach biznesowych, w których 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 arkusze kalkulacyjne programu Excel zachowają integralność i będą dostarczać weryfikowalnych informacji przez cały cykl ich życia.

Najczęściej zadawane pytania

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

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

Które formaty arkuszy kalkulacyjnych są obsługiwane w przypadku podpisywania metadanych?

GroupDocs.Signature dla platformy .NET obsługuje podpisywanie metadanych dla różnych formatów arkuszy kalkulacyjnych, w tym XLSX, XLS, XLSM, ODS i innych. Pełną listę można znaleźć w oficjalna dokumentacja.

Czy podpisy metadanych w arkuszach kalkulacyjnych są widoczne dla użytkowników?

Podpisy metadanych nie są widoczne w samej zawartości arkusza kalkulacyjnego. Można je jednak wyświetlić w panelu właściwości dokumentu w programie Excel lub innych kompatybilnych aplikacjach.

Czy mogę programowo sprawdzić, czy arkusz kalkulacyjny 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 dodawanie metadanych wpływa na funkcjonalność arkusza kalkulacyjnego?

Dodanie metadanych ma minimalny wpływ na rozmiar pliku i nie wpływa na funkcjonalność arkusza kalkulacyjnego. To prosty sposób na ulepszenie właściwości dokumentu bez wpływu na obliczenia, formuły ani inne funkcje programu Excel.

Gdzie mogę znaleźć więcej materiałów i wsparcia?