Přidejte vodoznak do dokumentů aplikace Word pomocí REST API v C#

Text nebo obrázek můžete přidat jako vodoznak do dokumentů Wordu programově v cloudu. Vodoznaky se používají k identifikaci tvůrce dokumentu nebo jiných informací, jako jsou autorská práva nebo logo atd. Vodoznak se obvykle používá ve formě překrývajícího se obrázku, loga, vzoru nebo textu umístěného uvnitř dokumentu. V tomto článku se dozvíte, jak přidat vodoznak do dokumentů aplikace Word pomocí REST API v C#.

Tento článek bude obsahovat následující témata:

Watermark REST API a .NET SDK

Pro přidání textového nebo obrazového vodoznaku do DOCX souborů budu používat .NET SDK GroupDocs.Watermark Cloud API. Umožňuje vám programově přidávat, odebírat, vyhledávat a nahrazovat vodoznaky z obrázků a dokumentů podporovaných formátů souborů, jako jsou PDF, Microsoft Word a Powerpoint. Kromě toho můžete ovládat přizpůsobení vodoznaků zadáním stylu textu, písma, velikosti, barvy nebo polohy podle vašich požadavků. V současné době také poskytuje Java SDK pro Cloud API.

GroupDocs.Watermark Cloud můžete nainstalovat do svého projektu Visual Studio ze Správce balíčků NuGet nebo pomocí následujícího příkazu v konzole Správce balíčků:

Install-Package GroupDocs.Watermark-Cloud

Než budete postupovat podle uvedených kroků, získejte prosím své ID klienta a tajný klíč z dashboard. Jakmile budete mít své ID a tajemství, přidejte kód, jak je uvedeno níže:

string clientId = "da0c487d-c1c0-45ae-b7bf-43eaf53c5ad5";
string clientSecret = "479db2b01dcb93a3d4d20efb16dea971";
string myStorage = "";

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

Přidejte textový vodoznak do dokumentů aplikace Word pomocí REST API v C#

Do dokumentů aplikace Word můžete programově přidat libovolný text jako vodoznak podle následujících jednoduchých kroků:

Nahrajte dokument

Nejprve nahrajte dokument Word do cloudu pomocí níže uvedeného příkladu kódu:

// inicializovat api
var fileApi = new FileApi(configuration);

// otevřít soubor
var fileStream = File.Open(@"C:\Files\sample.docx", FileMode.Open);

// vytvořit požadavek na nahrání souboru
var request = new UploadFileRequest("sample.docx", fileStream, MyStorage);

// nahrát soubor
fileApi.UploadFile(request);
fileStream.Close();

V důsledku toho bude soubor DOCX nahrán do cloudového úložiště a bude k dispozici v sekci souborů na vašem řídicím panelu.

Přidejte textový vodoznak do DOCX pomocí C#

Textový vodoznak můžete do souboru DOCX přidat programově podle následujících kroků.

  • Vytvořte instanci WatermarkApi
  • Vytvořte instanci souboru FileInfo
  • Nastavte cestu k souboru DOCX
  • Vytvořte možnosti WatermarkOptions a nastavte FileInfo
  • Vytvořte možnosti TextWatermark
  • Nastavte text, rodinu písem, velikost písma a zarovnání textu
  • Nastavte barvu popředí textu vodoznaku
  • Definujte pozici vodoznaku
  • Definujte podrobnosti vodoznaku a nastavte možnosti a polohu TextWatermark
  • Vytvořte AddRequest pomocí WatermarkOptions
  • Získejte výsledky voláním metody WatermarkApi.add()

Následující ukázka kódu ukazuje, jak přidat text jako vodoznak do dokumentu aplikace Word pomocí REST API v C#.

// inicializovat api
var apiInstance = new WatermarkApi(configuration);

// cesta k vstupnímu souboru
var fileInfo = new FileInfo
{
    FilePath = "sample.docx"
};

// vytvořit možnosti vodoznaku
var options = new WatermarkOptions()
{
    FileInfo = fileInfo,
    
    // definovat podrobnosti vodoznaku
    WatermarkDetails = new List<WatermarkDetails>
    {
        new WatermarkDetails
        {
            // definovat textový vodoznak
            TextWatermarkOptions = new TextWatermarkOptions
            {
                Text = "Copyright© 2021",
                FontFamilyName = "Arial",
                FontSize = 22d,
                TextAlignment = "Center",
                ForegroundColor = new Color()
                {
                    Name = "Red"
                }
            },

            // nastavit polohu vodoznaku
            Position = new Position()
            {
                X = 230.0,
                Y = 500.0
            }
        }
    }
};

// vytvořit žádost o přidání
var request = new AddRequest(options);

// přidat vodoznak
var response = apiInstance.Add(request);

Console.WriteLine("Resultant file path: " + response.DownloadUrl);
Přidejte textový vodoznak do dokumentů aplikace Word pomocí REST API v C#

Přidejte textový vodoznak do dokumentů aplikace Word pomocí REST API v C#

Stáhněte si aktualizovaný soubor

Výše uvedená ukázka kódu uloží soubor aplikace Word s textovým vodoznakem do cloudu. Můžete si jej stáhnout pomocí následující ukázky kódu:

// inicializovat api
var fileApi = new FileApi(configuration);

// výchozí cesta k souboru v cloudu
var file = "watermark/added_watermark/sample_docx/sample.docx";

// vytvořit žádost o stažení souboru
var downloadRequest = new DownloadFileRequest(file, myStorage);

// stáhnout soubor
Stream downloadResponse = fileApi.DownloadFile(downloadRequest);

// uložit soubor do pracovního adresáře
using (var fileStream = System.IO.File.Create("C:\\Files\\DownloadedFile.docx"))
{
    downloadResponse.Seek(0, SeekOrigin.Begin);
    downloadResponse.CopyTo(fileStream);
}

Přidejte vodoznak obrázku do dokumentů aplikace Word pomocí REST API

Do dokumentů Wordu můžete přidat obrázek nebo logo jako vodoznak programově podle následujících kroků.

  • Vytvořte instanci WatermarkApi
  • Vytvořte instanci souboru FileInfo
  • Nastavte cestu k souboru DOCX
  • Vytvořte možnosti WatermarkOptions a nastavte FileInfo
  • Vytvořte ImageWatermarkOptions
  • Nastavte FilePath obrázku PNG na vodoznak pomocí
  • Definujte pozici vodoznaku
  • Vytvořte podrobnosti o vodoznaku
  • Nastavte ImageWatermarkOptions a Position
  • Nastavte WatermarkDetails na List
  • Vytvořte AddRequest pomocí WatermarkOptions
  • Získejte výsledky voláním metody WatermarkApi.add()

Následující ukázka kódu ukazuje, jak přidat obrázek jako vodoznak do DOCX pomocí REST API v C#. Při nahrávání a stahování souborů postupujte podle výše uvedených kroků.

// inicializovat api
var apiInstance = new WatermarkApi(configuration);

// cesta k vstupnímu souboru
var fileInfo = new FileInfo
{
    FilePath = "sample.docx"
};

// vytvořit možnosti vodoznaku
var options = new WatermarkOptions()
{
    FileInfo = fileInfo,
    // definovat podrobnosti vodoznaku
    WatermarkDetails = new List<WatermarkDetails>
    {
        new WatermarkDetails
        {
            // definovat vodoznak obrázku
            ImageWatermarkOptions = new ImageWatermarkOptions()
            {
                Image = new FileInfo { 
                    FilePath = "logo.png" 
                }
            },

            // nastavit polohu vodoznaku
            Position = new Position()
            {
                X = 180.0,
                Y = 280.0
            }
        }
    }
};

// vytvořit žádost o přidání
var request = new AddRequest(options);

// přidat vodoznak
var response = apiInstance.Add(request);

Console.WriteLine("Resultant file path: " + response.DownloadUrl);
Přidejte vodoznak obrázku do obrázků pomocí REST API v C#

Přidejte vodoznak obrázku do dokumentů aplikace Word pomocí REST API v C#

Vyzkoušejte online

Vyzkoušejte prosím následující bezplatný online nástroj Watermark, který je vyvinut pomocí výše uvedeného API. https://products.groupdocs.app/watermark/docx

Závěr

Na závěr jste se naučili, jak přidat textový nebo obrázkový vodoznak do dokumentu aplikace Word v cloudu. Také jste se naučili, jak programově nahrát soubory DOCX do cloudu a poté stáhnout aktualizovaný soubor z cloudu. Více o GroupDocs.Watermark Cloud API se můžete dozvědět z dokumentace. Poskytujeme také sekci API Reference, která vám umožní vizualizovat a pracovat s našimi API přímo prostřednictvím prohlížeče. V případě jakýchkoliv nejasností se neváhejte obrátit na support.

Viz také