Bei den Dokumentmetadaten handelt es sich um Informationen über das Dokument, z. B. Autor, Bearbeitungszeit usw., die in einem Dokument gespeichert sind. Als C#-Entwickler können Sie die Metadateninformationen für PDF Dokumente problemlos programmgesteuert in der Cloud bearbeiten. In diesem Artikel erfahren Sie, wie Sie die Metadaten von PDF Dateien mithilfe einer REST-API in C# bearbeiten.

Die folgenden Themen sollen in diesem Artikel behandelt werden:

REST-API zur Bearbeitung von Dokumentmetadaten und .NET SDK

groupdocsmetadata-for-cloud

Zum Bearbeiten von Metadaten eines PDF Dokuments verwende ich die .NET SDK of GroupDocs.Metadata Cloud API. Es ermöglicht Ihnen, Metadaten aus fast allen branchenüblichen Dateiformaten hinzuzufügen, zu bearbeiten, abzurufen und zu entfernen. Sie können solche Vorgänge für PDF, Microsoft Word, Excel-Tabellen, PowerPoint-Präsentationen, Outlook-E-Mails, Visio, OneNote, Project, Audio, Video, AutoCAD, Archiv, JPEG, BMP, PNG und TIFF ausführen. Es stellt außerdem Java SDK als Mitglieder der Dokumentmetadaten-Manipulationsfamilie für die Cloud-API bereit.

Sie können das GroupDocs.Metadata Cloud SDK für .NET wie unten gezeigt über den NuGet-Paketmanager in Ihrem Visual Studio-Projekt installieren:

Installieren Sie GroupDocs.Metadata Cloud über den NuGet Package Manager

Installieren Sie GroupDocs.Metadata Cloud über den NuGet Package Manager

Sie können das Paket NuGet auch mit dem folgenden Befehl in der Package Manager-Konsole installieren:

Install-Package GroupDocs.Metadata-Cloud

Bitte rufen Sie Ihre Client-ID und Ihr Client-Geheimnis vom Dashboard ab, bevor Sie mit dem Befolgen der Schritte und verfügbaren Codebeispiele beginnen. Sobald Sie Ihre Kunden-ID und Ihr Geheimnis haben, fügen Sie den Code wie unten gezeigt ein:

string clientID = "112f0f38-9dae-42d5-b4fc-cc84ae644972";
string clientSecret = "16ad3fe0bdc39c910f57d2fd48a5d618";
string myStorage = "";

Configuration configuration = new Configuration(clientID, clientSecret);
configuration.ApiBaseUrl = "https://api.groupdocs.cloud";

Bearbeiten Sie Metadaten von PDF Dateien mithilfe der REST-API in C#

Sie können Metadaten von PDF Dokumenten festlegen, indem Sie die folgenden einfachen Schritte ausführen:

Laden Sie das Dokument hoch

Laden Sie zunächst die PDF-Datei mit dem unten angegebenen Codebeispiel in die Cloud hoch:

# API-Initialisierung
FileApi fileApi = new FileApi(configuration);
string path = @"C:\Files";

var file = Directory.GetFiles(path, "input.pdf", SearchOption.AllDirectories).FirstOrDefault();
if (file.Length != 0)
{
    var relativeFilePath = file.Replace(path, string.Empty).Trim(Path.DirectorySeparatorChar);

    var fileStream = File.Open(file, FileMode.Open);

    fileApi.UploadFile(new UploadFileRequest(relativeFilePath, fileStream, myStorage));
    fileStream.Close();
}

Dadurch ist die hochgeladene PDF-Datei (input.pdf) im Dateienbereich Ihres Dashboards in der Cloud verfügbar.

Metadaten von PDF Dateien mit C# aktualisieren

Sie können die Metadaten einer PDF-Datei programmgesteuert aktualisieren, indem Sie die folgenden Schritte ausführen.

  • Erstellen Sie eine Instanz von MetadataApi
  • Legen Sie den PDF-Dateipfad im FileInfo-Modell fest
  • Definieren Sie SetOptions
  • Geben Sie NewValue und Type für SetPropert an
  • Definieren Sie SearchCriteria und geben Sie NameOptions an, für die der Wert aktualisiert werden soll
  • Erstellen Sie SetRequest mit SetOptions
  • Erhalten Sie Ergebnisse, indem Sie die Methode MetadataApi.Set() aufrufen

Das folgende Codebeispiel zeigt, wie die Metadaten anhand des Eigenschaftsnamens eines PDF Dokuments mithilfe einer REST-API festgelegt werden.

# API-Initialisierung
var apiInstance = new MetadataApi(configuration);

try
{
    var fileInfo = new GroupDocs.Metadata.Cloud.Sdk.Model.FileInfo
    {
        FilePath = "input.pdf",
        StorageName = myStorage
    };
    
    // Definieren Sie Set-Optionen
    var options = new SetOptions
    {
        FileInfo = fileInfo,
        Properties = new List<SetProperty>
        {
            new SetProperty
            {
                NewValue = "hello",
                Type = "String",
                SearchCriteria = new SearchCriteria
                {
                    NameOptions = new NameOptions
                    {
                        Value = "Keywords"
                    }
                },
            }
        }
    };
    
    // Set-Anfrage definieren
    var request = new SetRequest(options);

    var response = apiInstance.Set(request);
    Console.WriteLine($"Count of changes: {response.SetCount}");
    Console.WriteLine("Resultant file path: " + response.Path);
}
catch (Exception e)
{
    Console.WriteLine("Exception while calling MetadataApi: " + e.Message);
}
Bearbeiten Sie Metadaten von PDF Dokumenten mithilfe der REST-API in C#

Legen Sie Metadaten nach Eigenschaftsnamen fest

Der folgende Codeausschnitt zeigt, wie der genaue Eigenschaftsname abgeglichen wird, indem die ExactPhrase-Eigenschaft auf True gesetzt wird:

# API-Initialisierung
var apiInstance = new MetadataApi(configuration);
var fileInfo = new GroupDocs.Metadata.Cloud.Sdk.Model.FileInfo
{
    FilePath = "input.pdf",
    StorageName = myStorage
};

// Definieren Sie Set-Optionen
var options = new SetOptions
{
    FileInfo = fileInfo,
    Properties = new List<SetProperty>
    {
        new SetProperty
        {
            NewValue = "This is title",
            Type = "String",
            SearchCriteria = new SearchCriteria
            {
                NameOptions = new NameOptions
                {
                    Value = "Title",
                    MatchOptions = new MatchOptions
                    {
                        ExactPhrase = true
                    }
                }
            },
        }
    }
};

// Set-Anfrage definieren
var request = new SetRequest(options);

var response = apiInstance.Set(request);
Bearbeiten Sie Metadaten, indem Sie mithilfe der REST-API in C# den genauen Eigenschaftsnamen in PDF Dokumenten abgleichen.

Legen Sie Metadaten fest, indem Sie den genauen Eigenschaftsnamen abgleichen

Der folgende Codeausschnitt zeigt, wie Suchkriterien mithilfe regulärer Ausdrücke definiert werden, um die MatchOptions bereitzustellen:

# API-Initialisierung
var apiInstance = new MetadataApi(configuration);
var fileInfo = new GroupDocs.Metadata.Cloud.Sdk.Model.FileInfo
{
    FilePath = "input.pdf",
    StorageName = myStorage
};

// Definieren Sie Set-Optionen
var options = new SetOptions
{
    FileInfo = fileInfo,
    Properties = new List<SetProperty>
    {
        new SetProperty
        {
            NewValue = "new value",
            Type = "String",
            SearchCriteria = new SearchCriteria
            {
                NameOptions = new NameOptions
                {
                    Value = "^Tit.*",
                    MatchOptions = new MatchOptions
                    {
                        IsRegex = true
                    }
                }
            },
        }
    }
};

// Set-Anfrage definieren
var request = new SetRequest(options);

var response = apiInstance.Set(request);
Bearbeiten Sie Metadaten, indem Sie den Eigenschaftsnamen mithilfe eines regulären Ausdrucks in PDF Dokumenten mithilfe der REST-API in C# abgleichen.

Legen Sie Metadaten fest, indem Sie den Eigenschaftsnamen mit einem regulären Ausdruck abgleichen

Der folgende Codeausschnitt zeigt, wie die Metadaten durch Bereitstellung des Eigenschaftswerts aktualisiert werden:

# API-Initialisierung
var apiInstance = new MetadataApi(configuration);
var fileInfo = new GroupDocs.Metadata.Cloud.Sdk.Model.FileInfo
{
    FilePath = "input.pdf",
    StorageName = myStorage
};

// Definieren Sie Set-Optionen
var options = new SetOptions
{
    FileInfo = fileInfo,
    Properties = new List<SetProperty>
    {
        new SetProperty
        {
            NewValue = "Simply set by Property Value",
            Type = "String",
            SearchCriteria = new SearchCriteria
            {
                ValueOptions = new ValueOptions
                {
                    Value = "Windows User",
                    Type = "String"
                }
            },
        }
    }
};

// Set-Anfrage definieren
var request = new SetRequest(options);

var response = apiInstance.Set(request);
Bearbeiten Sie Metadaten, indem Sie Eigenschaftswerte in PDF Dokumenten mithilfe der REST-API in C# abgleichen.

Legen Sie Metadaten nach übereinstimmendem Eigenschaftswert fest

Laden Sie die aktualisierte Datei herunter

Die oben genannten Codebeispiele speichern die aktualisierte PDF-Datei in der Cloud und können mit dem folgenden Codebeispiel heruntergeladen werden:

# API-Initialisierung
var fileApi = new FileApi(configuration);
var file = "metadata\\set_metadata\\input_pdf\\input.pdf";
var downloadRequest = new DownloadFileRequest(file, myStorage);

Stream downloadResponse = fileApi.DownloadFile(downloadRequest);
using (var fileStream = File.Create("C:\\Files\\sample_input.pdf"))
{
    downloadResponse.Seek(0, SeekOrigin.Begin);
    downloadResponse.CopyTo(fileStream);
}

Versuchen Sie es online

Bitte probieren Sie das folgende kostenlose Online-Tool zur Bearbeitung von PDF-Metadaten aus, das mit der oben genannten API entwickelt wurde.

https://products.groupdocs.app/metadata/pdf

Abschluss

In diesem Artikel haben Sie erfahren, wie Sie die Metadaten von PDF Dokumenten in der Cloud bearbeiten. In diesem Artikel wurde auch erläutert, wie Sie programmgesteuert eine PDF-Datei in die Cloud hochladen und dann die aktualisierte Datei aus der Cloud herunterladen. Weitere Informationen zur GroupDocs.Metadata Manipulation Cloud API finden Sie in der Dokumentation. Wir bieten auch einen Abschnitt API-Referenz an, mit dem Sie unsere APIs direkt über den Browser visualisieren und mit ihnen interagieren können. Bei Unklarheiten können Sie uns gerne im Forum kontaktieren.

Siehe auch