Заменить текст в документе и сохранить – GroupDocs.Editor .NET

Введение

Если вам нужно replace text in document программно, GroupDocs.Editor для .NET предоставляет чистый, высокопроизводительный способ сделать это. В этом руководстве мы пройдём процесс загрузки Word‑файла, замены строки и последующего сохранения результата в нескольких популярных форматах, таких как RTF, DOCM и обычный текст. Независимо от того, создаёте ли вы сервис автоматизации документов или добавляете функцию быстрого исправления во внутренний инструмент, нижеописанные шаги позволят вам начать работу за считанные минуты.

Быстрые ответы

• Какой самый простой способ заменить текст? Загрузите файл с помощью Editor, измените HTML и вызовите Save у EditableDocument.
• В какие форматы можно сохранять? Поддерживаются RTF, DOCM и TXT «из коробки».
• Нужна ли полная установка Office? Нет – GroupDocs.Editor полностью работает на сервере.
• Какие версии .NET требуются? .NET Framework 4.6.1 или новее, .NET Core 3.1 +, .NET 5/6 – все поддерживаются.
• Обязательна ли лицензия для продакшна? Да, коммерческая лицензия снимает ограничения оценки; доступна бесплатная пробная версия.

Что такое «замена текста в документе»?

«Replace text in document» означает программный поиск конкретной строки внутри файла и её замену новым содержимым без ручного редактирования. Эта операция важна для массовых обновлений, шаблонизации или генерации документов на основе данных. Она позволяет разработчикам автоматизировать персонализацию документов, применять регуляторные изменения в нескольких файлах и интегрировать динамическую генерацию контента в более крупные рабочие процессы.

Почему использовать GroupDocs.Editor для .NET?

GroupDocs.Editor поддерживает 30+ входных и выходных форматов — включая DOCX, RTF, TXT, HTML, PDF и ODT — при обработке файлов до 500 МБ без загрузки всего документа в память. API работает на Windows, Linux и macOS, предоставляя кроссплатформенную гибкость и 99,9 % уровень успеха при работе со сложными макетами, согласно внутренним тестам.

Требования

• Среда разработки: Visual Studio (любая современная версия).
• .NET Framework: 4.6.1 или новее (или .NET Core 3.1 +).
• GroupDocs.Editor for .NET: Скачайте последнюю версию здесь.
• Базовые знания C#: Знакомство с классами, методами и манипуляциями со строками.

Для подробного использования обратитесь к официальной documentation.

Импорт пространств имён

Для начала импортируйте необходимые пространства имён для редактирования и сохранения документов.

Класс Editor является точкой входа для всех операций манипуляции документами.

// Placeholder for import statements – keep unchanged
```csharp
using System.IO;
using GroupDocs.Editor.Formats;
using GroupDocs.Editor.Options;

Теперь, когда среда готова, перейдём к конкретным шагам для replace text in document.

Как заменить текст в документе с помощью GroupDocs.Editor?

Загрузите исходный файл с помощью Editor, получите его HTML‑представление, выполните простую операцию Replace над строкой HTML, а затем создайте новый EditableDocument из изменённого HTML. В конце вызовите соответствующий перегруженный метод Save для целевого формата.

Шаг 1: Загрузить документ

Объект EditableDocument хранит представление файла в памяти.

Класс Editor загружает файл и возвращает EditableDocument, которым вы можете управлять.

// Placeholder for loading code – keep unchanged
```csharp
string inputFilePath = "Your Sample Document";
Editor editor = new Editor(inputFilePath, delegate { return new Options.WordProcessingLoadOptions(); });
EditableDocument defaultWordProcessingDoc = editor.Edit();

Шаг 2: Изменить документ

Поскольку GroupDocs.Editor работает с HTML‑снимком, вы можете рассматривать документ как обычный текст для простых замен.

Метод EditableDocument.GetHtml() извлекает HTML; после изменения строки вы создаёте новый EditableDocument из обновлённого HTML.

// Placeholder for modification code – keep unchanged
```csharp
string allEmbeddedInsideString = defaultWordProcessingDoc.GetEmbeddedHtml();
string allEmbeddedInsideStringEdited = allEmbeddedInsideString.Replace("Subtitle", "Edited subtitle");
EditableDocument editedDoc = EditableDocument.FromMarkup(allEmbeddedInsideStringEdited, null);

Шаг 3: Сохранить документ

GroupDocs.Editor предоставляет специализированные методы Save для каждого поддерживаемого формата. Ниже три распространённых варианта.

Сохранить как RTF

Метод SaveAsRtf записывает отредактированное содержимое в Rich Text Format, сохраняя большую часть стилей.

// Placeholder for RTF save code – keep unchanged
```csharp
string outputRtfPath = Path.Combine(Constants.GetOutputDirectoryPath(inputFilePath), "editedDoc.rtf");
WordProcessingSaveOptions rtfSaveOptions = new WordProcessingSaveOptions(WordProcessingFormats.Rtf);
editor.Save(editedDoc, outputRtfPath, rtfSaveOptions);

Сохранить как DOCM

DOCM — это формат Word с поддержкой макросов; используйте SaveAsDocm, когда необходимо сохранить возможности макросов.

// Placeholder for DOCM save code – keep unchanged
```csharp
string outputDocmPath = Path.Combine(Constants.GetOutputDirectoryPath(inputFilePath), "editedDoc.docm");
WordProcessingSaveOptions docmSaveOptions = new WordProcessingSaveOptions(WordProcessingFormats.Docm);
using (FileStream outputStream = File.Create(outputDocmPath))
{
    editor.Save(editedDoc, outputStream, docmSaveOptions);
}

Сохранить как обычный текст

Для лёгкого вывода SaveAsTxt удаляет форматирование и возвращает чистый текст.

// Placeholder for TXT save code – keep unchanged
```csharp
string outputTxtPath = Path.Combine(Constants.GetOutputDirectoryPath(inputFilePath), "editedDoc.txt");
TextSaveOptions textSaveOptions = new TextSaveOptions
{
    Encoding = System.Text.Encoding.UTF8,
    PreserveTableLayout = true
};
editor.Save(editedDoc, outputTxtPath, textSaveOptions);

Шаг 4: Очистка

Всегда освобождайте экземпляры EditableDocument и Editor, чтобы закрыть файловые дескрипторы и неуправляемые ресурсы.

Шаблон Dispose гарантирует удаление временных файлов и освобождение памяти.

// Placeholder for cleanup code – keep unchanged
```csharp
editedDoc.Dispose();
defaultWordProcessingDoc.Dispose();
editor.Dispose();

Распространённые проблемы и решения

Часто задаваемые вопросы

Q: Какие форматы файлов поддерживает GroupDocs.Editor?
A: GroupDocs.Editor работает более чем с 30 форматами, включая DOCX, RTF, TXT, HTML, PDF и ODT. Полный список см. в официальной документации.

Q: Могу ли я попробовать GroupDocs.Editor перед покупкой?
A: Да, вы можете получить бесплатную пробную версию здесь.

Q: Есть ли поддержка, если я столкнусь с проблемами?
A: Конечно — посетите форум поддержки здесь для помощи от сообщества и команды продукта.

Q: Как получить временную лицензию для оценки?
A: Запросите временную лицензию здесь.

Q: Где можно приобрести полную версию GroupDocs.Editor?
A: Полную версию можно купить здесь.

Последнее обновление: 2026-05-27
Тестировано с: GroupDocs.Editor 2.10 for .NET
Автор: GroupDocs

Связанные руководства

• Как редактировать и сохранять Word‑документы с помощью GroupDocs.Editor для .NET: Полное руководство
• Конвертация Word в HTML с помощью GroupDocs.Editor .NET: Пошаговое руководство
• Эффективное редактирование документов с GroupDocs.Editor .NET: Преобразование HTML в редактируемые документы