この記事では、NET REST API を使用して Word にブックマークを追加するプロセスについて説明します。 Aspose.Words for .NET Cloud SDK を使用して、C# ローコード API で Word ドキュメントにブックマークを追加します。さまざまなブックマーク パラメーターを設定し、API 呼び出しを呼び出して、このブックマークをローカル ディスク上の Word ファイルに追加します。
前提条件
- アカウントを作成して API 認証情報を取得する
- ダウンロード Aspose.Words Cloud SDK for Dotnet to add a bookmark in a Word file
- 上記の SDK を使用して C# ソリューション プロジェクトをセットアップします
NET REST API を使用して Word でブックマークを作成する手順
- ブックマークを追加するための API のクライアント ID とクライアント シークレットを設定します。
- クライアント資格情報を使用して WordsApi クラスのオブジェクトをインスタンス化します。
- ブックマークを作成するためにソース Word ファイルをメモリ ストリームに読み込みます
- PositionInsideNode クラスを使用してブックマークの開始範囲と終了範囲を定義します。
- 必要なパラメータを指定して InsertBookmarkOnlineRequest オブジェクトを作成します
- InsertBookmarkOnlineRequest に従って、InsertBookmarkOnline メソッドを insert a bookmark に呼び出します。
- 結果の Word ファイルを新しいブックマークとともに保存します
前述の手順では、C# ロー コード API を使用して Word でブックマークを作成する方法 を説明しています。 WordsApi オブジェクトを作成してプロセスを開始し、続いてソース Word ファイルを読み取り、ブックマーク パラメーターを定義します。最後に、いくつかの API 呼び出しを呼び出してこのブックマークを Word ファイルに追加し、その後、結果の Word ファイルをローカル ディスクに保存します。
C# REST API を使用して Word にブックマークを挿入するコード
| using System; | |
| using System.IO; | |
| using Aspose.Words.Cloud.Sdk; | |
| using Aspose.Words.Cloud.Sdk.Model; | |
| using Aspose.Words.Cloud.Sdk.Model.Requests; | |
| namespace WordsSample.Words | |
| { | |
| public class Bookmarks | |
| { | |
| public void AddBookmark() | |
| { | |
| try | |
| { | |
| // Set the client secret and ID | |
| var config = new Configuration(); | |
| config.ClientSecret = "Client Secret"; | |
| config.ClientId = "Client ID"; | |
| // Instantiate the WordsApi object | |
| var wordsApi = new WordsApi(config); | |
| // Read the input file | |
| using var requestDocument = File.OpenRead("Sample.docx"); | |
| // Define start and end range for the bookmark | |
| var requestBookmarkStartRange = new PositionInsideNode | |
| { | |
| NodeId = "0.0.0.0", | |
| Offset = 0 | |
| }; | |
| var requestBookmarkEndRange = new PositionInsideNode() | |
| { | |
| NodeId = "0.0.0.0", | |
| Offset = 0 | |
| }; | |
| // Initialize the BookmarkInsert object | |
| var requestBookmark = new BookmarkInsert() | |
| { | |
| StartRange = requestBookmarkStartRange, | |
| EndRange = requestBookmarkEndRange, | |
| Name = "new_bookmark", | |
| Text = "Some text" | |
| }; | |
| string output = "output.docx"; | |
| // Insert the bookmark | |
| var insertRequest = new InsertBookmarkOnlineRequest(requestDocument, requestBookmark,destFileName:output); | |
| var insertTask = wordsApi.InsertBookmarkOnline(insertRequest); | |
| insertTask.Wait(); | |
| var result = insertTask.Result; | |
| // Save the Word file with the bookmark | |
| if (result.Document.TryGetValue(output, out var stream)) | |
| { | |
| stream.Position = 0; | |
| using (var fileStream = File.Create(output)) | |
| { | |
| stream.Seek(0, SeekOrigin.Begin); | |
| stream.CopyTo(fileStream); | |
| } | |
| } | |
| } | |
| catch (Exception e) | |
| { | |
| Console.WriteLine(e.Message); | |
| } | |
| } | |
| } | |
| } |
このサンプル コードでは、C# REST API を使用して Word にブックマークを追加する方法 を示します。 PositionInsideNode クラスは、宛先 Word ファイル内のブックマークの開始範囲と終了範囲を設定するために使用されます。結果のストリームは、指定されたキーを持つ辞書アイテムとして返され、サンプル コードで示されているように TryGetValue メソッドを使用して取得できます。
このトピックでは、C# REST API を使用して Word でブックマークを作成する方法を学習しました。 Word ファイルを HTML ファイルに変換する場合は、NET REST API を使用して DOCX を HTML に変換する の記事を参照してください。
