Zobrazení dokumentů aplikace Word jako stránek HTML pomocí REST API v C#

Jako vývojář v jazyce C# můžete snadno vykreslovat soubory DOC nebo DOCX na stránky HTML programově ve svých aplikacích .NET v cloudu. Může to být užitečné při sdílení vašich dokumentů Word jako responzivních HTML stránek s příslušnými zúčastněnými stranami. V tomto článku se dozvíte, jak prohlížet dokumenty Wordu jako stránky HTML pomocí REST API v C#.

• Word to HTML Viewer REST API a .NET SDK
• Zobrazení Wordu jako HTML stránek pomocí REST API v C#
• Vykreslování stránek Word do HTML s možnostmi vykreslování pomocí C#
• Vykreslování Word do HTML s vodoznakem pomocí C#

Word to HTML Viewer REST API a .NET SDK

Pro vykreslení DOC nebo DOCX souborů do HTML budu používat .NET SDK of GroupDocs.Viewer Cloud API. Umožňuje vám programově vykreslovat a prohlížet všechny druhy oblíbených formátů dokumentů a obrázků, jako jsou Word, Excel, PDF, PowerPoint, Visio, Project, Outlook, JPG, PNG atd.

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

Install-Package GroupDocs.Viewer-Cloud

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

string MyClientId = "112f0f38-9dae-42d5-b4fc-cc84ae644972";
string MyClientSecret = "16ad3fe0bdc39c910f57d2fd48a5d618";
string MyStorage = "";

var configuration = new Configuration(MyClientId, MyClientSecret);

Zobrazení dokumentů aplikace Word jako stránek HTML pomocí REST API v C#

Dokumenty Wordu můžete zobrazit jako stránky HTML v cloudu podle jednoduchých kroků uvedených níže:

• Nahrajte soubor DOCX do cloudu
• Vykreslit Word do HTML pomocí C#
• Stáhnout vykreslené HTML stránky

Nahrajte dokument

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

// inicializovat API
var apiInstance = new FileApi(configuration);

// Otevřete soubor v IOStream z místního disku/disku.
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
var response = apiInstance.UploadFile(request);

V důsledku toho bude nahraný soubor DOCX dostupný v sekce souborů vašeho řídicího panelu.

Vykreslování stránek Word do HTML pomocí C#

Dokumenty Wordu můžete vykreslit na stránky HTML programově podle následujících kroků:

• Vytvořte instanci rozhraní ViewAPI
• Vytvořte instanci souboru FileInfo
• Zadejte cestu k vstupnímu souboru
• Vytvořte instanci ViewOptions
• Přiřaďte FileInfo k ViewOptions
• Nastavte ViewFormat jako „HTML“
• Vytvořte požadavek na zobrazení voláním metody CreateViewRequest pomocí ViewOptions
• Získejte odpověď voláním metody CreateView() s CreateViewRequest

Následující ukázka kódu ukazuje, jak vykreslit dokument aplikace Word na stránky HTML pomocí rozhraní REST API v C#.

// inicializovat API
var apiInstance = new ViewApi(configuration);

// cesta k vstupnímu souboru
var fileInfo = new GroupDocs.Viewer.Cloud.Sdk.Model.FileInfo();
fileInfo.FilePath = "sample.docx";

// definovat možnosti zobrazení
var viewOptions = new ViewOptions();
viewOptions.FileInfo = fileInfo;
viewOptions.ViewFormat = ViewOptions.ViewFormatEnum.HTML;   // output view format

// vytvořit požadavek na zobrazení
var request = new CreateViewRequest(viewOptions);

// vytvořit pohled
var response = apiInstance.CreateView(request);

Stáhněte si vykreslené HTML stránky

Výše uvedená ukázka kódu uloží vykreslené stránky HTML do cloudu. Můžete si je stáhnout pomocí následující ukázky kódu:

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

// uložit všechny vykreslené HTML stránky
foreach (var page in response.Pages)
{
    // vytvořit žádost o stažení souboru
    var downloadFileRequest = new DownloadFileRequest(page.Path, MyStorage);

    // stáhnout soubor
    var file = fileApi.DownloadFile(downloadFileRequest);
    
    // uložit soubor do pracovního adresáře
    using (var fileStream = System.IO.File.Create("C:\\Files\\" + page.Path))
    {
        file.Seek(0, SeekOrigin.Begin);
        file.CopyTo(fileStream);
    }
}

Vykreslování stránek Word do HTML s možnostmi vykreslování pomocí C#

Můžete použít konkrétní možnosti vykreslování k programovému vykreslení dokumentů Word na stránky HTML podle následujících kroků:

• Vytvořte instanci rozhraní ViewAPI
• Vytvořte instanci souboru FileInfo
• Zadejte cestu k vstupnímu souboru
• Vytvořte instanci ViewOptions
• Přiřaďte FileInfo k ViewOptions
• Nastavte ViewFormat jako „HTML“
• Vytvořte instanci RenderOptions
• Nastavte různé možnosti vykreslování, jako je PagesToRender, RenderComments atd.
• Vytvořte požadavek na zobrazení voláním metody CreateViewRequest pomocí ViewOptions
• Získejte odpověď voláním metody CreateView() s CreateViewRequest

Následující ukázka kódu ukazuje, jak vykreslit dokument aplikace Word na stránky HTML s možnostmi vykreslení pomocí REST API v C#.

// inicializovat API
var apiInstance = new ViewApi(configuration);

// cesta k vstupnímu souboru
var fileInfo = new GroupDocs.Viewer.Cloud.Sdk.Model.FileInfo();
fileInfo.FilePath = "sample.docx";

// definovat možnosti zobrazení
var viewOptions = new ViewOptions();
viewOptions.FileInfo = fileInfo;
viewOptions.ViewFormat = ViewOptions.ViewFormatEnum.HTML;   // output view format

// definovat možnosti vykreslení
viewOptions.RenderOptions = new RenderOptions
{
    // vykreslovat komentáře
    RenderComments = true,

    // vykreslovat konkrétní rozsah stránek
    StartPageNumber = 1,
    CountPagesToRender = 2,
};

// vytvořit požadavek na zobrazení
var request = new CreateViewRequest(viewOptions);

// vytvořit pohled
var response = apiInstance.CreateView(request);

Vykreslování Word do HTML s vodoznakem pomocí C#

Při programovém vykreslování dokumentů aplikace Word do HTML můžete přidat text vodoznaku podle následujících kroků:

• Vytvořte instanci rozhraní ViewAPI
• Vytvořte instanci souboru FileInfo
• Zadejte cestu k vstupnímu souboru
• Vytvořte instanci ViewOptions
• Přiřaďte FileInfo k ViewOptions
• Nastavte ViewFormat jako „HTML“
• Definujte možnost zobrazení vodoznaku
• Nastavte text, velikost, barvu a polohu vodoznaku
• Vytvořte požadavek na zobrazení voláním metody CreateViewRequest pomocí ViewOptions
• Získejte odpověď voláním metody CreateView() s CreateViewRequest

Následující ukázka kódu ukazuje, jak přidat text vodoznaku na vykreslené stránky HTML pomocí REST API v C#.

// inicializovat API
var apiInstance = new ViewApi(configuration);

// cesta k vstupnímu souboru
var fileInfo = new GroupDocs.Viewer.Cloud.Sdk.Model.FileInfo();
fileInfo.FilePath = "sample.docx";

// definovat možnosti zobrazení
var viewOptions = new ViewOptions();
viewOptions.FileInfo = fileInfo;
viewOptions.ViewFormat = ViewOptions.ViewFormatEnum.HTML;   // output view format

// definovat vodoznak
viewOptions.Watermark = new Watermark
{
    Text = "This is a sample watermark!",
    Size = 100,
    Color = "Red",
    Position = Watermark.PositionEnum.Diagonal
};
          
// vytvořit požadavek na zobrazení
var request = new CreateViewRequest(viewOptions);

// vytvořit pohled
var response = apiInstance.CreateView(request);

Vyzkoušejte online

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

Závěr

V tomto článku jste se naučili, jak zobrazit dokumenty aplikace Word jako stránky HTML v cloudu. Také jste se naučili vykreslovat Word do HTML s možnostmi vykreslování v C#. Navíc jste se naučili, jak přidat textový vodoznak do vykreslených stránek HTML programově pomocí C#. Dále jste se naučili, jak programově nahrát soubor DOCX do cloudu a následně stáhnout vykreslené HTML soubory z cloudu. Více o GroupDocs.Viewer Cloud API se můžete dozvědět pomocí 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í nás neváhejte kontaktovat na fóru.

Viz také

• GroupDocs.Viewer Cloud verze V2