Expose a REST API to Watermark Word Documents
ファイルの先頭に必要な using ディレクティブを追加します。
このチュートリアルは、…について案内します ASP.NET Core で Word 文書に透かしを追加する REST API を公開する方法. 手順はステップバイステップで、セットアップの詳細や主要プラットフォーム向けのデプロイガイドラインが含まれています。.
ステップ 8: 画像プロパティを設定
- 挿入した画像のサイズと位置を調整します。.
- インストール Aspose.Words for .NET NuGet パッケージ マネージャー経由で。.
- 手順9:画像をリンクされたファイルとして追加.
- カーソルを最後の段落に移動し、画像をファイルへのリンクとして追加します。.
- ステップ10:ドキュメントを保存.
- 最後に、変更した Word ドキュメントをディスクに保存します。.
- .
これらの手順は、作成および公開するための詳細なアプローチを提供します。 ウォーターマーク API.
以下は、前述のすべての手順を含む完全な例です:
結論:
using System.IO;
using System.Threading.Tasks;
using Aspose.Words;
using Microsoft.AspNetCore.Http;
using Microsoft.AspNetCore.Mvc;
namespace WatermarkAPI.Controllers
{
[ApiController]
[Route("api/[controller]")]
public class WatermarkController : ControllerBase
{
[HttpPost("add-watermark")]
public async Task<IActionResult> AddWatermark(IFormFile file, [FromQuery] string watermarkText)
{
if (file == null || file.Length == 0 || string.IsNullOrWhiteSpace(watermarkText))
return BadRequest("Please upload a valid Word document and provide a watermark text.");
try
{
var tempFilePath = Path.GetTempFileName();
using (var stream = new FileStream(tempFilePath, FileMode.Create))
{
await file.CopyToAsync(stream);
}
Document doc = new Document(tempFilePath);
TextWatermarkOptions options = new TextWatermarkOptions
{
FontFamily = "Arial",
FontSize = 40,
Color = System.Drawing.Color.LightGray,
Layout = WatermarkLayout.Diagonal,
IsSemitrasparent = true
};
doc.Watermark.SetText(watermarkText, options);
var outputStream = new MemoryStream();
doc.Save(outputStream, SaveFormat.Docx);
outputStream.Position = 0;
return File(outputStream, "application/vnd.openxmlformats-officedocument.wordprocessingml.document", "watermarked.docx");
}
catch (System.Exception ex)
{
return StatusCode(500, $"Internal server error: {ex.Message}");
}
}
}
}このチュートリアルでは、C# を使用して Word ドキュメントに画像を追加する方法を示しました。これらの手順に従うことで、埋め込み画像とリンク画像の両方を含めることができ、Word ドキュメントの美観と情報品質を向上させることができます。さらに探求する場合は、既存のファイルに依存せずにプログラムで Word ドキュメントを作成することを検討してください。
Windows
- C# を使用して MS Word ドキュメントのテーブルにプログラムで行を追加する方法を、コードスニペットとステップバイステップの手順を交えて学びます。.
- Aspose.Words と Aspose.Words.Tables 名前空間をインポートします。:
Linux
- 行を追加したいテーブルをインデックスで取得します。:
- Aspose.Words と Aspose.Words.Tables 名前空間をインポートします。:
- 行にテキスト段落を含むいくつかのセルを追加します。.
macOS
- 以下から .NET ランタイムをインストールします。 公式サイト .
- 追加したテーブル行を含む MS Word ドキュメントを再保存します。:
一般的な問題と対処法
- 無効な入力エラー: アップロードされたファイルが有効な Word ドキュメントであり、ウォーターマーク テキストが空でないことを確認してください。.
- アクセス拒否エラー: Linux/macOS では、アプリケーションフォルダーに適切な権限を付与してください。.
- パフォーマンスの問題: 大きなファイルの場合、ストリームではなくディスクから直接ファイルを処理することでメモリ使用量を最適化してください。.
このガイドでは、Word 文書に透かしを追加する REST API を作成する方法を示しました Aspose.Words for .NET そして、すべての主要プラットフォームにデプロイする方法も示しました.