Вы можете программно добавить текст или изображение в качестве водяного знака в документы Word в облаке. Водяные знаки используются для идентификации создателя документа или другой информации, такой как авторские права или логотип и т. д. Обычно водяной знак используется в виде наложенного изображения, логотипа, узора или текста, размещенного внутри документа. В этой статье вы узнаете, как добавить водяной знак в документы Word с помощью REST API на C#.
В этой статье должны быть раскрыты следующие темы:
- Водяной знак REST API и пакет SDK для .NET
- Добавить текстовый водяной знак в документы Word с помощью REST API в C#
- Добавить водяной знак изображения в документы Word с помощью REST API
Водяной знак REST API и пакет SDK для .NET
Для добавления текстового или графического водяного знака в файлы DOCX я буду использовать .NET SDK of GroupDocs.Watermark Cloud API. Он позволяет программно добавлять, удалять, искать и заменять водяные знаки с изображений и документов поддерживаемых форматов файлов, таких как PDF, Microsoft Word и Powerpoint. Кроме того, вы можете управлять настройкой водяных знаков, указав стиль текста, шрифт, размер, цвет или положение в соответствии с вашими требованиями. В настоящее время он также предоставляет Java SDK для облачного API.
Вы можете установить GroupDocs.Watermark Cloud в свой проект Visual Studio из диспетчера пакетов NuGet или с помощью следующей команды в консоли диспетчера пакетов:
Install-Package GroupDocs.Watermark-Cloud
Прежде чем выполнять указанные шаги, получите свой идентификатор клиента и секрет на панели управления. Получив свой идентификатор и секрет, добавьте код, как показано ниже:
string clientId = "da0c487d-c1c0-45ae-b7bf-43eaf53c5ad5";
string clientSecret = "479db2b01dcb93a3d4d20efb16dea971";
string myStorage = "";
var configuration = new Configuration(clientId, clientSecret);
configuration.ApiBaseUrl = "https://api.groupdocs.cloud";
Добавить текстовый водяной знак в документы Word с помощью REST API в C#
Вы можете программно добавить любой текст в качестве водяного знака в документы Word, выполнив простые шаги, указанные ниже:
- Загрузить the DOCX file to the Cloud
- Добавить текстовый водяной знак в DOCX с помощью C#
- Скачать the watermarked file
Загрузить документ
Во-первых, загрузите документ Word в облако, используя приведенный ниже пример кода:
// инициализировать API
var fileApi = new FileApi(configuration);
// открыть файл
var fileStream = File.Open(@"C:\Files\sample.docx", FileMode.Open);
// создать запрос на загрузку файла
var request = new UploadFileRequest("sample.docx", fileStream, MyStorage);
// загрузить файл
fileApi.UploadFile(request);
fileStream.Close();
В результате файл DOCX будет загружен в облачное хранилище и будет доступен в разделе файлов вашей панели управления.
Добавить текстовый водяной знак в DOCX с помощью C#
Вы можете программно добавить текстовый водяной знак в файл DOCX, выполнив шаги, указанные ниже.
- Создайте экземпляр WatermarkApi
- Создайте экземпляр FileInfo
- Установите путь к файлу DOCX
- Создайте WatermarkOptions и установите FileInfo
- Создать TextWatermarkOptions
- Установите текст, семейство шрифтов, размер шрифта и выравнивание текста
- Установить цвет переднего плана текста водяного знака
- Определите положение водяного знака
- Определите WatermarkDetails и установите TextWatermarkOptions и Position
- Создать AddRequest с WatermarkOptions
- Получите результаты, вызвав метод WatermarkApi.add().
В следующем примере кода показано, как добавить текст в качестве водяного знака в документ Word с помощью REST API на C#.
// инициализировать API
var apiInstance = new WatermarkApi(configuration);
// путь к входному файлу
var fileInfo = new FileInfo
{
FilePath = "sample.docx"
};
// создать параметры водяного знака
var options = new WatermarkOptions()
{
FileInfo = fileInfo,
// определить детали водяного знака
WatermarkDetails = new List<WatermarkDetails>
{
new WatermarkDetails
{
// определить текстовый водяной знак
TextWatermarkOptions = new TextWatermarkOptions
{
Text = "Copyright© 2021",
FontFamilyName = "Arial",
FontSize = 22d,
TextAlignment = "Center",
ForegroundColor = new Color()
{
Name = "Red"
}
},
// установить положение водяного знака
Position = new Position()
{
X = 230.0,
Y = 500.0
}
}
}
};
// создать запрос на добавление
var request = new AddRequest(options);
// Добавить водный знак
var response = apiInstance.Add(request);
Console.WriteLine("Resultant file path: " + response.DownloadUrl);
Добавить текстовый водяной знак в документы Word с помощью REST API в C#
Загрузите обновленный файл
Приведенный выше пример кода сохранит файл Word с текстовым водяным знаком в облаке. Вы можете загрузить его, используя следующий пример кода:
// инициализировать API
var fileApi = new FileApi(configuration);
// путь к файлу по умолчанию в облаке
var file = "watermark/added_watermark/sample_docx/sample.docx";
// создать запрос на скачивание файла
var downloadRequest = new DownloadFileRequest(file, myStorage);
// Загрузка файла
Stream downloadResponse = fileApi.DownloadFile(downloadRequest);
// сохранить файл в рабочем каталоге
using (var fileStream = System.IO.File.Create("C:\\Files\\DownloadedFile.docx"))
{
downloadResponse.Seek(0, SeekOrigin.Begin);
downloadResponse.CopyTo(fileStream);
}
Добавить водяной знак изображения в документы Word с помощью REST API
Вы можете программно добавить изображение или логотип в качестве водяного знака в документы Word, выполнив шаги, указанные ниже.
- Создайте экземпляр WatermarkApi
- Создайте экземпляр FileInfo
- Установите путь к файлу DOCX
- Создайте WatermarkOptions и установите FileInfo
- Создать ImageWatermarkOptions
- Установите FilePath изображения PNG в водяной знак с помощью
- Определите положение водяного знака
- Создать водяной знакДетали
- Установить ImageWatermarkOptions и положение
- Установите WatermarkDetails в список
- Создать AddRequest с WatermarkOptions
- Получите результаты, вызвав метод WatermarkApi.add().
В следующем примере кода показано, как добавить изображение в качестве водяного знака в DOCX с помощью REST API на C#. Пожалуйста, следуйте шагам, упомянутым ранее, чтобы загрузить и скачать файлы.
// инициализировать API
var apiInstance = new WatermarkApi(configuration);
// путь к входному файлу
var fileInfo = new FileInfo
{
FilePath = "sample.docx"
};
// создать параметры водяного знака
var options = new WatermarkOptions()
{
FileInfo = fileInfo,
// определить детали водяного знака
WatermarkDetails = new List<WatermarkDetails>
{
new WatermarkDetails
{
// определить водяной знак изображения
ImageWatermarkOptions = new ImageWatermarkOptions()
{
Image = new FileInfo {
FilePath = "logo.png"
}
},
// установить положение водяного знака
Position = new Position()
{
X = 180.0,
Y = 280.0
}
}
}
};
// создать запрос на добавление
var request = new AddRequest(options);
// Добавить водный знак
var response = apiInstance.Add(request);
Console.WriteLine("Resultant file path: " + response.DownloadUrl);
Добавить водяной знак изображения в документы Word с помощью REST API в C#
Попробуйте онлайн
Пожалуйста, попробуйте следующий бесплатный онлайн-инструмент водяных знаков, разработанный с использованием вышеуказанного API. https://products.groupdocs.app/watermark/docx
Заключение
В заключение вы узнали, как добавить текстовый или графический водяной знак в документ Word в облаке. Вы также узнали, как программно загружать файлы DOCX в облако, а затем загружать обновленный файл из облака. Вы можете узнать больше о GroupDocs.Watermark Cloud API из документации. Мы также предоставляем раздел Справочник по API, который позволяет визуализировать наши API и взаимодействовать с ними непосредственно через браузер. В случае возникновения неясностей обращайтесь в поддержку.