Puede agregar un texto o una imagen como marca de agua a sus documentos de Word mediante programación en la nube. Las marcas de agua se utilizan para identificar al creador del documento u otra información como derechos de autor o logotipo, etc. Por lo general, la marca de agua se utiliza en forma de una imagen superpuesta, logotipo, patrón o texto colocado dentro del documento. En este artículo, aprenderá cómo agregar una marca de agua a documentos de Word usando una API REST en C#.
En este artículo se tratarán los siguientes temas:
- API REST de marca de agua y SDK de .NET
- Agregar marca de agua de texto a documentos de Word usando la API REST en C#
- Agregue una marca de agua de imagen a documentos de Word usando la API REST
API REST de marca de agua y SDK de .NET
Para agregar una marca de agua de texto o imagen a los archivos DOCX, utilizaré la API .NET SDK de GroupDocs.Watermark Cloud. Le permite agregar, eliminar, buscar y reemplazar mediante programación marcas de agua de imágenes y documentos de los formatos de archivo admitidos, como PDF, Microsoft Word y Powerpoint. Además, puede controlar la personalización de las marcas de agua especificando el estilo del texto, la fuente, el tamaño, el color o la posición según sus requisitos. Actualmente, también proporciona Java SDK para Cloud API.
Puede instalar GroupDocs.Watermark Cloud en su proyecto de Visual Studio desde NuGet Package Manager o usando el siguiente comando en la consola de Package Manager:
Install-Package GroupDocs.Watermark-Cloud
Obtenga su ID de cliente y secreto del panel de control antes de seguir los pasos mencionados. Una vez que tenga su ID y secreto, agregue el código como se muestra a continuación:
string clientId = "da0c487d-c1c0-45ae-b7bf-43eaf53c5ad5";
string clientSecret = "479db2b01dcb93a3d4d20efb16dea971";
string myStorage = "";
var configuration = new Configuration(clientId, clientSecret);
configuration.ApiBaseUrl = "https://api.groupdocs.cloud";
Agregar marca de agua de texto a documentos de Word usando la API REST en C#
Puede agregar cualquier texto como marca de agua a sus documentos de Word mediante programación siguiendo los sencillos pasos que se mencionan a continuación:
- Subir the DOCX file to the Cloud
- Agregar marca de agua de texto a DOCX usando C#
- Descargar the watermarked file
Sube el documento
En primer lugar, cargue el documento de Word en la nube utilizando el ejemplo de código que se muestra a continuación:
// inicializar API
var fileApi = new FileApi(configuration);
// abrir documento
var fileStream = File.Open(@"C:\Files\sample.docx", FileMode.Open);
// crear solicitud de carga de archivo
var request = new UploadFileRequest("sample.docx", fileStream, MyStorage);
// subir archivo
fileApi.UploadFile(request);
fileStream.Close();
Como resultado, el archivo DOCX se cargará en el almacenamiento en la nube y estará disponible en la sección de archivos de su tablero.
Agregar marca de agua de texto a DOCX usando C#
Puede agregar una marca de agua de texto al archivo DOCX mediante programación siguiendo los pasos que se detallan a continuación.
- Cree una instancia de WatermarkApi
- Crear una instancia de FileInfo
- Establecer la ruta del archivo DOCX
- Crear WatermarkOptions y establecer FileInfo
- Crear TextWatermarkOptions
- Establezca el texto, la familia de fuentes, el tamaño de fuente y la alineación del texto
- Establecer el color de primer plano del texto de la marca de agua
- Definir la posición de la marca de agua
- Definir WatermarkDetails y establecer TextWatermarkOptions y Position
- Crear AddRequest con WatermarkOptions
- Obtenga resultados llamando al método WatermarkApi.add()
El siguiente ejemplo de código muestra cómo agregar texto como marca de agua a un documento de Word mediante una API REST en C#.
// inicializar API
var apiInstance = new WatermarkApi(configuration);
// ruta del archivo de entrada
var fileInfo = new FileInfo
{
FilePath = "sample.docx"
};
// crear opciones de marca de agua
var options = new WatermarkOptions()
{
FileInfo = fileInfo,
// definir los detalles de la marca de agua
WatermarkDetails = new List<WatermarkDetails>
{
new WatermarkDetails
{
// definir marca de agua de texto
TextWatermarkOptions = new TextWatermarkOptions
{
Text = "Copyright© 2021",
FontFamilyName = "Arial",
FontSize = 22d,
TextAlignment = "Center",
ForegroundColor = new Color()
{
Name = "Red"
}
},
// establecer la posición de la marca de agua
Position = new Position()
{
X = 230.0,
Y = 500.0
}
}
}
};
// crear agregar solicitud
var request = new AddRequest(options);
// añadir marca de agua
var response = apiInstance.Add(request);
Console.WriteLine("Resultant file path: " + response.DownloadUrl);
Agregar marca de agua de texto a documentos de Word usando la API REST en C#
Descargar el archivo actualizado
El ejemplo de código anterior guardará el archivo de Word con una marca de agua de texto en la nube. Puede descargarlo utilizando el siguiente ejemplo de código:
// inicializar API
var fileApi = new FileApi(configuration);
// ruta de archivo predeterminada en la nube
var file = "watermark/added_watermark/sample_docx/sample.docx";
// crear solicitud de archivo de descarga
var downloadRequest = new DownloadFileRequest(file, myStorage);
// descargar archivo
Stream downloadResponse = fileApi.DownloadFile(downloadRequest);
// guardar archivo en el directorio de trabajo
using (var fileStream = System.IO.File.Create("C:\\Files\\DownloadedFile.docx"))
{
downloadResponse.Seek(0, SeekOrigin.Begin);
downloadResponse.CopyTo(fileStream);
}
Agregue una marca de agua de imagen a documentos de Word usando la API REST
Puede agregar una imagen o un logotipo como marca de agua a sus documentos de Word mediante programación siguiendo los pasos que se detallan a continuación.
- Cree una instancia de WatermarkApi
- Crear una instancia de FileInfo
- Establecer la ruta del archivo DOCX
- Crear WatermarkOptions y establecer FileInfo
- Crear imagenMarca de aguaOpciones
- Establezca FilePath de una imagen PNG en marca de agua con
- Definir la posición de la marca de agua
- Crear marca de aguaDetalles
- Establecer opciones de marca de agua de imagen y posición
- Establecer detalles de marca de agua en la lista
- Crear AddRequest con WatermarkOptions
- Obtenga resultados llamando al método WatermarkApi.add()
El siguiente ejemplo de código muestra cómo agregar una imagen como marca de agua a DOCX mediante una API REST en C#. Siga los pasos mencionados anteriormente para cargar y descargar los archivos.
// inicializar API
var apiInstance = new WatermarkApi(configuration);
// ruta del archivo de entrada
var fileInfo = new FileInfo
{
FilePath = "sample.docx"
};
// crear opciones de marca de agua
var options = new WatermarkOptions()
{
FileInfo = fileInfo,
// definir los detalles de la marca de agua
WatermarkDetails = new List<WatermarkDetails>
{
new WatermarkDetails
{
// definir marca de agua de imagen
ImageWatermarkOptions = new ImageWatermarkOptions()
{
Image = new FileInfo {
FilePath = "logo.png"
}
},
// establecer la posición de la marca de agua
Position = new Position()
{
X = 180.0,
Y = 280.0
}
}
}
};
// crear agregar solicitud
var request = new AddRequest(options);
// añadir marca de agua
var response = apiInstance.Add(request);
Console.WriteLine("Resultant file path: " + response.DownloadUrl);
Agregar marca de agua de imagen a documentos de Word usando REST API en C#
Prueba en línea
Pruebe la siguiente herramienta gratuita de marca de agua en línea, que se desarrolla utilizando la API anterior. https://products.groupdocs.app/watermark/docx
Conclusión
En conclusión, ha aprendido cómo agregar una marca de agua de texto o imagen a un documento de Word en la nube. También aprendió cómo cargar mediante programación los archivos DOCX en la nube y luego descargar el archivo actualizado desde la nube. Puede obtener más información sobre GroupDocs.Watermark Cloud API en la documentación. También proporcionamos una sección Referencia de API que le permite visualizar e interactuar con nuestras API directamente a través del navegador. En caso de cualquier ambigüedad, no dude en ponerse en contacto con soporte.