1. Обзор компонента Spire.Doc for .NET

Free Spire.Doc for .NET — это профессиональный компонент для работы с документами Word, который позволяет разработчикам создавать, читать, изменять и конвертировать документы Word напрямую через код без установки Microsoft Office. Компонент предоставляет полный набор возможностей для работы с водяными знаками и поддерживает два основных типа:

В отличие от сложных решений, имитирующих водяные знаки через колонтитулы или вставку фигур, Spire.Doc содержит встроенную объектную модель для работы с водяными знаками, что делает их добавление и управление более простым и стандартизированным.

Настройка окружения

Перед началом кодирования необходимо установить Free Spire.Doc в проект через диспетчер пакетов NuGet. Выполните следующую команду в «Консоли диспетчера пакетов» Visual Studio:

Install-Package FreeSpire.Doc

После установки необходимо подключить следующие пространства имён в файле кода:

using Spire.Doc;

using Spire.Doc.Documents;

using System.Drawing; // Для работы с цветами и изображениями

2. Добавление текстового водяного знака

Текстовый водяной знак — это самая базовая и наиболее часто используемая форма водяных знаков. По сути, это строка текста, отображаемая на фоне каждой страницы документа в полупрозрачном или заданном цвете. Обычно используется крупный шрифт с диагональным или горизонтальным расположением, чтобы визуально отличаться от основного содержимого.

Описание основных свойств

Класс TextWatermark предоставляет следующие настраиваемые свойства:

Реализация кода

using System;

using System.Drawing;

using Spire.Doc;

using Spire.Doc.Documents;

namespace InsertTextWatermark

{

internal class Program

{

static void Main(string[] args)

{

// Создание экземпляра объекта Document

Document document = new Document();

// Загрузка документа Word с диска

document.LoadFromFile("input.docx");

// Вставка текстового водяного знака

InsertTextWatermark(document);

// Сохранение документа

document.SaveToFile("TextWatermark.docx", FileFormat.Docx);

}

private static void InsertTextWatermark(Document document)

{

TextWatermark txtWatermark = new TextWatermark();

txtWatermark.Text = "НЕ КОПИРОВАТЬ"; // Текст водяного знака

txtWatermark.FontSize = 50; // Размер шрифта

txtWatermark.Color = Color.Blue; // Цвет текста

txtWatermark.Layout = WatermarkLayout.Diagonal; // Диагональное расположение

document.Watermark = txtWatermark;

}

}

}

Ключевые моменты

• Водяной знак связан со всем объектом документа, а не с отдельной страницей или разделом. Это означает, что после добавления водяной знак автоматически применяется ко всем страницам документа.

• При сохранении необходимо явно указать формат FileFormat.Docx, чтобы информация о водяном знаке была корректно записана в структуру файла Word.

• Если требуется горизонтальное центрированное отображение водяного знака, установите свойство Layout в WatermarkLayout.Horizontal.

3. Добавление водяного знака-изображения

По сравнению с текстовыми водяными знаками, водяные знаки-изображения подходят для более широкого круга сценариев:

• Добавление логотипа компании в качестве водяного знака во внутренние документы

• Наложение изображений с авторскими правами на дизайнерские макеты

• Использование изображения подписи как утверждающего водяного знака документа

Описание основных свойств

Класс PictureWatermark предоставляет следующие настраиваемые свойства:

Реализация кода

using System;

using System.Drawing;

using Spire.Doc;

using Spire.Doc.Documents;

namespace InsertImageWatermark

{

internal class Program

{

static void Main(string[] args)

{

// Создание экземпляра объекта Document

Document document = new Document();

// Загрузка документа Word

document.LoadFromFile("Input.docx");

// Вставка водяного знака-изображения

InsertImageWatermark(document);

// Сохранение документа

document.SaveToFile("InsertImageWatermark.docx", FileFormat.Docx);

}

private static void InsertImageWatermark(Document document)

{

PictureWatermark picture = new PictureWatermark();

picture.Picture = Image.FromFile("watermark.png"); // Загрузка изображения

picture.Scaling = 200; // Масштаб (%)

picture.IsWashout = false; // Использовать ли эффект выцветания

document.Watermark = picture;

}

}

}

Два визуальных эффекта для водяного знака-изображения

4. Удаление водяного знака

Жизненный цикл документа обычно включает несколько этапов, и необходимость в водяных знаках не всегда постоянна. Например, документ на стадии проверки может требовать заметного водяного знака «Конфиденциально», но после завершения проверки и официальной публикации водяной знак может стать лишним и потребовать удаления.

Принцип работы

В Spire.Doc удаление водяного знака реализовано очень просто: свойство Document.Watermark по сути является ссылкой на объект. Когда оно указывает на экземпляр TextWatermark или PictureWatermark, это означает, что водяной знак активен. Если же присвоить этому свойству пустую ссылку, водяной знак будет удалён из документа.

Реализация кода

using Spire.Doc;

namespace RemoveWatermark

{

class Program

{

static void Main(string[] args)

{

// Создание экземпляра Document

Document doc = new Document();

// Загрузка документа Word с водяным знаком

doc.LoadFromFile("Input.docx");

// Удаление водяного знака

doc.Watermark = null;

// Сохранение результата

doc.SaveToFile("RemoveWatermark.docx", FileFormat.Docx2013);

}

}

}

⚠️ Важные замечания

Этот способ удаления работает только для стандартных водяных знаков, добавленных через Spire.Doc. Если «водяной знак» реализован нестандартным способом (например, полупрозрачная фигура в колонтитуле или встроенное фоновое изображение), данный метод не сработает — потребуется использовать другие стратегии удаления содержимого документа.

5. Заключение

С помощью Spire.Doc for .NET разработчики могут легко и стандартизированно добавлять и удалять водяные знаки в документах Word с использованием C#. Основные операции, рассмотренные в статье:

Рекомендации по применению

• Текстовые водяные знаки : подходят для сценариев с динамической генерацией текста, например отображения различных уровней конфиденциальности в зависимости от прав пользователя

• Водяные знаки-изображения : подходят для брендированных сценариев, когда компания использует единый логотип в качестве фона документа

• Удаление водяных знаков : подходит для документооборота, например когда документы содержат водяной знак на этапе внутреннего согласования и очищаются перед внешней публикацией

Это решение не зависит от среды Microsoft Office и подходит для развёртывания в серверных приложениях и фоновых службах, обеспечивая хорошую стабильность и масштабируемость.

- сравнить с похожими вариантами, с которыми его легко перепутать;

- разобрать, где решение нормальное, а где уже есть запахи.

Позже подключил ИИ как помощника именно для такой практики. Не чтобы он просто писал код за меня, а чтобы подкидывал задания, задавал новые вариации и помогал разбирать, где моя логика хромает. И вот тогда паттерны начали восприниматься не как абстрактная теория, а как повторяющиеся ходы, которые реально можно замечать в проектировании.

Для себя я из этого вынес простую мысль: паттерны нормально заходят не через чтение определений, а через многократное распознавание, сравнение и разбор.

В итоге я даже собрал для себя небольшой тренажерный формат, чтобы гонять такие упражнения регулярно. Не как “энциклопедию паттернов”, а именно как практику на узнавание, различение и разбор решений.

Вообще интересно, у кого как это было.

У вас паттерны тоже начали нормально укладываться только через практику?

Или, наоборот, книги по паттернам GoF сразу заходят без боли?

Или через .NET CLI:

dotnet add package Spire.PDF

Библиотека поддерживает .NET Framework 4.0 и выше, .NET Core 3.1, .NET 5.0 и более поздние версии.

Код реализации

Ниже приведён полный пример кода:

using System.IO;

using System.Net;

using Spire.Pdf;

namespace DownloadPdfFromUrl

{

class Program

{

static void Main(string[] args)

{

// Создаём объект PdfDocument

PdfDocument doc = new PdfDocument();

// Создаём объект WebClient для загрузки веб-ресурсов

WebClient webClient = new WebClient();

// Скачиваем данные PDF по URL в поток памяти (MemoryStream)

using (MemoryStream ms = new MemoryStream(

webClient.DownloadData("http://www.example.com/sample.pdf")))

{

// Загружаем данные PDF из потока в объект PdfDocument

doc.LoadFromStream(ms);

}

// Сохраняем PDF-документ в локальный файл

doc.SaveToFile("result.pdf", FileFormat.PDF);

// Освобождаем ресурсы

webClient.Dispose();

doc.Close();

}

}

}

Пояснение к коду

1. Создание объекта PdfDocument

PdfDocument — это основной класс Spire.PDF, представляющий экземпляр PDF-документа. Он используется для хранения и обработки PDF-данных, загруженных из интернета.

2. Использование WebClient для скачивания данных

WebClient — это простой класс загрузки по HTTP в .NET. Метод DownloadData возвращает byte[], который представляет собой исходное бинарное содержимое PDF-файла.

3. Использование MemoryStream как “моста”

Обёртка массива байт в MemoryStream позволяет использовать метод doc.LoadFromStream(ms). Это избавляет от неэффективного процесса сохранения файла на диск, а затем чтения его обратно — и даёт возможность обрабатывать данные в памяти.

4. Загрузка и сохранение PDF

Метод LoadFromStream анализирует поток памяти и формирует пригодный для использования PDF-документ. Затем метод SaveToFile сохраняет документ в локальное хранилище под именем файла result.pdf.

Примечания

• Обработка исключений : В производственных средах рекомендуется добавлять блоки try-catch для обработки сетевых таймаутов, недействительных URL, ошибок формата PDF и других исключений.

• Управление памятью : И WebClient, и PdfDocument реализуют интерфейс IDisposable, поэтому ресурсы должны быть корректно освобождены. В примере MemoryStream обрабатывается через using, но также рекомендуется явно освобождать webClient и doc или оборачивать их в блоки using .

• Асинхронная версия : Для больших файлов рассмотрите использование WebClient.DownloadDataTaskAsync или переход на HttpClient с асинхронными методами, чтобы не блокировать UI-поток.

• Корректность URL : Убедитесь, что URL напрямую указывает на PDF-файл, а не на страницу перенаправления.

Расширенные сценарии

С помощью Spire.PDF вы можете выполнять дополнительные операции сразу после загрузки PDF, например:

• Извлечение текста или изображений

• Объединение нескольких PDF-файлов

• Добавление водяных знаков или колонтитулов (верхний/нижний)

• Конвертация PDF в изображения или формат Word

Итог

В этой статье показано, как скачать PDF по URL и сохранить его локально с помощью C# и Spire.PDF для .NET. Весь процесс простой и эффективный — требуется всего несколько строк ключевого кода.

Spire.PDF — это не только инструмент для загрузки и сохранения документов, но и мощная библиотека для обработки PDF, которую стоит изучить дальше.

Шифрование документов Word

Шифрование документов Word — это эффективный способ защиты важной информации. Установив пароль, мы можем предотвратить доступ несанкционированных пользователей к содержимому документа. Ниже приведен пример программы на C#, демонстрирующий, как использовать Spire.Doc для шифрования документа Word:

using Spire.Doc;

namespace PasswordProtectWordDocument

{

class Program

{

static void Main(string[] args)

{

// Создаем объект Document

Document document = new Document();

// Загружаем файл Word

document.LoadFromFile(@"C:\Users\Administrator\Desktop\Input.docx");

// Шифруем документ с помощью пароля

document.Encrypt("open-psd");

// Сохраняем зашифрованный документ в новый файл Word

document.SaveToFile("Encryption.docx", FileFormat.Docx);

}

}

}

В приведенном коде мы сначала создаем объект Document и загружаем существующий файл Word с помощью метода LoadFromFile. Затем используем метод Encrypt, чтобы зашифровать документ и задать пароль. После завершения шифрования мы сохраняем его как новый файл, тем самым создавая зашифрованный документ Word.

Установка разрешений на документы

Кроме шифрования, установка разрешений на документы также важный способ защиты файлов Word. Разные настройки разрешений позволяют пользователям иметь только определенные права операций. Вот образец кода, демонстрирующий, как установить разрешения на документы:

using Spire.Doc;

namespace ChangeDocumentPermission

{

class Program

{

static void Main(string[] args)

{

// Создаем объект Document

Document document = new Document();

// Загружаем документ Word

document.LoadFromFile(@"C:\Users\Administrator\Desktop\Input.docx");

// Устанавливаем разрешения на документ и задаем пароль для разрешений

document.Protect(ProtectionType.AllowOnlyFormFields, "permission-psd");

// Сохраняем документ с установленными разрешениями в новый файл Word

document.SaveToFile("Permission.docx");

}

}

}

В этом примере мы также создаем объект Document и загружаем файл Word. Затем используем метод Protect, чтобы установить разрешения. Здесь мы можем задать различные типы защиты, например, AllowOnlyFormFields, что означает, что пользователи могут только заполнять поля формы без редактирования других содержимых.

Типы защиты

Spire.Doc предоставляет несколько типов защиты на выбор, позволяя контролировать разрешения доступа к документам:

• AllowOnlyComments: Разрешает только комментарии к документу.

• AllowOnlyFormFields: Разрешает только заполнение полей формы.

• AllowOnlyReading: Разрешает только чтение документа.

• AllowOnlyRevisions: Разрешает только внесение изменений.

• NoProtection: Без защиты; любой пользователь может свободно редактировать документ.

Заключение

Использовать Free Spire.Doc для .NET для шифрования и защиты документов Word очень просто. С помощью приведенных примеров разработчики могут быстро начать работу и удовлетворить свои потребности в защите документов. Защита документов не только сохраняет безопасность информации, но и улучшает пользовательский опыт, обеспечивая конфиденциальность в процессе обмена. С этими инструментами пользователи могут более уверенно работать с документами, защищая важную информацию как для себя, так и для других.

Автоматизация управления макросами полезна во многих реальных сценариях:

• Потоки автоматизации документов — встроить вспомогательные макросы в сгенерированные отчеты

• Рабочие процессы безопасности — удалить макросы перед внешним обменом

• Задачи по обслуживанию — удалить устаревшие модули автоматизации

• Пакетная обработка — управлять макросами в сотнях документов

Вместо того чтобы вручную редактировать файлы, вы можете интегрировать управление макросами непосредственно в ваши C# приложения.

Установка необходимой библиотеки

Установите Spire.Doc для .NET через NuGet:

Install-Package Spire.Doc

Понимание структуры VBA в документах Word

При работе с макросами программно полезно понимать иерархию:

Документ Word
└── VBA проект
└── Модули
└── Макросы (процедуры Sub)

Удаление проекта VBA удаляет все, в то время как удаление модуля удаляет только конкретный код.

Метод 1 — Добавление макроса в документ Word

Этот пример вставляет простой макрос, который выделяет выбранный текст.

Это макрос, подходящий для начинающих, который демонстрирует, как работают проекты и модули VBA.

Что делает этот пример

• Создает проект VBA

• Добавляет модуль

• Вставляет процедуру макроса

• Сохраняет документ как .docm

using Spire.Doc;

namespace AddMacro

{

class Program

{

static void Main(string[] args)

{

Document doc = new Document();

doc.LoadFromFile(@"Input.docx");

// Создание проекта VBA

VbaProject vbaProject = new VbaProject();

vbaProject.Name = "MyMacros";

doc.VbaProject = vbaProject;

// Добавление модуля

VbaModule vbaModule = doc.VbaProject.Modules.Add(

"HighlightModule",

VbaModuleType.StdModule);

// Вставка макроса

vbaModule.SourceCode = @"

Sub HighlightSelectedText()

If Selection.Range.Text <> """" Then

Selection.Range.HighlightColorIndex = wdYellow

Else

MsgBox ""Please select some text first.""

End If

End Sub

";

doc.SaveToFile("AddMacroResult.docm", FileFormat.Docm);

doc.Dispose();

}

}

}

Метод 2 — Удаление всех макросов из документа Word

Иногда вам нужно полностью удалить автоматизацию перед обменом документами или конвертацией их в PDF.

Этот метод удаляет весь проект VBA из файла.

Что делает этот пример

• Проверяет, существуют ли макросы

• Удаляет весь проект VBA

• Сохраняет чистый документ

using Spire.Doc;

namespace RemoveVBAMacros

{

internal class Program

{

static void Main(string[] args)

{

Document doc = new Document();

doc.LoadFromFile(@"Input.docm");

// Удаление всех макросов

if (doc.IsContainMacro)

{

doc.ClearMacros();

}

doc.SaveToFile("RemoveAllMacros.docx", FileFormat.Docx);

doc.Dispose();

}

}

}

Это идеально подходит для:

• безопасного распределения документов

• рабочих процессов соответствия

• удаления потенциально небезопасной автоматизации

Метод 3 — Удаление конкретного модуля VBA

Вместо того чтобы удалять все, вы можете удалить только один модуль, сохранив остальную автоматизацию.

Что делает этот пример

• Обнаруживает наличие макроса

• Удаляет только один модуль

• Сохраняет оставшиеся макросы

using Spire.Doc;

namespace RemoveVBAModule

{

internal class Program

{

static void Main(string[] args)

{

Document doc = new Document();

doc.LoadFromFile(@"Input.docm");

if (doc.IsContainMacro &&

doc.VbaProject != null &&

doc.VbaProject.Modules.Count > 0)

{

string moduleName = doc.VbaProject.Modules[0].Name;

doc.VbaProject.Modules.Remove(moduleName);

}

doc.SaveToFile("RemoveSpecificModule.docm", FileFormat.Docm);

doc.Dispose();

}

}

}

Это полезно при:

• обновлении устаревших макросов

• удалении устаревших функций

• рефакторинге модулей автоматизации

Заключительные мысли

Управление проектами Word VBA с помощью C# дает вам мощный контроль над рабочими процессами автоматизации документов. Вместо ручного редактирования файлов вы можете:

• внедрять полезные макросы в сгенерированные документы

• очищать файлы перед распределением

• выборочно поддерживать модули автоматизации

Объединив эти методы, вы можете создать масштабируемые конвейеры обработки документов, которые будут одновременно гибкими и безопасными.