Este artículo describe el proceso para agregar un marcador en Word con NET REST API. Usaremos Aspose.Words para .NET Cloud SDK para agregar un marcador al documento de Word con C# Low Code API. Establecerá varios parámetros de marcador e invocará llamadas API para agregar este marcador a su archivo de Word en el disco local.
Requisito previo
- Crear una cuenta y obtener credenciales API
- Descargar Aspose.Words Cloud SDK for Dotnet to add a bookmark in a Word file
- Configurar el proyecto de solución C# con el SDK anterior
Pasos para crear un marcador en Word con NET REST API
- Configure el ID de cliente y el secreto de cliente para que la API agregue un marcador
- Cree una instancia de un objeto de la clase WordsApi con sus credenciales de cliente
- Lea el archivo de Word fuente en la secuencia de memoria para crear un marcador
- Defina el rango inicial y final del marcador usando la clase PositionInsideNode
- Cree el objeto InsertBookmarkOnlineRequest proporcionando los parámetros necesarios
- Llame al método InsertBookmarkOnline a insert a bookmark de acuerdo con InsertBookmarkOnlineRequest
- Guarde el archivo de Word resultante con el nuevo marcador
Los pasos antes mencionados describen cómo crear un marcador en Word con C# Low Code API. Comience el proceso creando un objeto WordsApi, luego lea el archivo de Word fuente y defina los parámetros del marcador. Finalmente, agregue este marcador a su archivo de Word realizando algunas llamadas API y luego guardando el archivo de Word resultante en el disco local.
Código para insertar un marcador en Word con API REST de C#
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); | |
} | |
} | |
} | |
} |
Este código de muestra muestra cómo agregar un marcador en Word con la API REST de C#. La clase PositionInsideNode se utiliza para establecer el rango inicial y final del marcador en el archivo de Word de destino. La secuencia resultante se devuelve como un elemento de diccionario con la clave especificada y se puede recuperar mediante el método TryGetValue como se muestra en el código de muestra.
En este tema, hemos aprendido cómo crear un marcador en Word con la API REST de C#. Si desea convertir un archivo de Word en un archivo HTML, consulte el artículo sobre Convierta DOCX a HTML con NET REST API.