Обработка CSS‑контента с префиксом

В этом руководстве вы узнаете как обрабатывать префикс CSS при работе с таблицами стилей внутри документа с использованием GroupDocs.Editor для .NET. Если вам нужно добавить URL‑префикс к изображениям, шрифтам или любому внешнему ресурсу, приведённые ниже шаги покажут, как именно обрабатывать префикс CSS и также как извлекать CSS‑контент для дальнейшей обработки.

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

  • Что означает “handle css prefix”? Добавление пользовательского URL‑префикса к внешним ресурсам, указанным в CSS.
  • Какой метод API возвращает стили CSS? EditableDocument.GetCssContent(...).
  • Нужна ли лицензия? Доступна пробная лицензия; для продакшн‑использования требуется коммерческая лицензия.
  • Какие версии .NET поддерживаются? .NET Framework 4.5+ и .NET Core/5/6.
  • Можно ли изменить префикс во время выполнения? Да — просто передайте другую строку в GetCssContent.

Что такое handle css prefix?

Применение префикса к ресурсам CSS переписывает пути к изображениям, шрифтам или другим активам, чтобы они указывали на расположение, которым вы управляете (например, CDN или защищённый сервер). Это особенно полезно при экспорте документа, когда необходимо, чтобы все внешние ссылки были доступны из веб‑приложения.

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

GroupDocs.Editor может читать оригинальный CSS, встроенный в документы WordProcessing, предоставлять вам необработанные строки таблиц стилей и позволять манипулировать ими перед рендерингом или сохранением. Это устраняет необходимость ручного парсинга и гарантирует, что извлечённый CSS соответствует внутреннему представлению документа.

Предварительные требования

Before we get started, make sure you have the following prerequisites in place:

  • Visual Studio: Вам понадобится рабочая установка Visual Studio.
  • .NET Framework: Убедитесь, что .NET Framework установлен.
  • GroupDocs.Editor for .NET: Вы можете скачать его here.
  • Sample Document: Подготовьте образец документа для редактирования.

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

Сначала импортируем необходимые пространства имён, чтобы наш код работал без проблем. Этот шаг даёт доступ к основным классам GroupDocs.Editor.

using System;
using System.Collections.Generic;
using GroupDocs.Editor.Options;

Шаг 1: Инициализация Editor

Первый шаг заключается в создании экземпляра Editor с вашим образцом документа. Это настраивает среду редактирования.

using (Editor editor = new Editor("Your Sample Document", delegate { return new WordProcessingLoadOptions(); }))
{

Шаг 2: Редактирование документа

Далее мы получаем объект EditableDocument. Этот объект представляет редактируемую версию файла и позволяет работать с его внутренними частями.

    using (EditableDocument document = editor.Edit(new WordProcessingEditOptions()))
    {

Шаг 3: Установка внешних префиксов

Определите URL‑префиксы для изображений и шрифтов. Эти префиксы будут добавлены к каждой ссылке на изображение и шрифт, найденной в CSS.

        string externalImagesPrefix = "http://www.mywebsite.com/images/id=";
        string externalFontsPrefix = "http://www.mywebsite.com/fonts/id=";

Шаг 4: Extract CSS content с префиксами

Вызовите GetCssContent, передав префиксы, которые вы только что определили. Метод возвращает список строк таблиц стилей CSS, уже содержащих префиксные URL.

        List<string> stylesheets = document.GetCssContent(externalImagesPrefix, externalFontsPrefix);

Шаг 5: Вывод результатов

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

        Console.WriteLine("There are {0} stylesheets in the input document", stylesheets.Count);
        foreach (string css in stylesheets)
        {
            Console.WriteLine(css);
        }
    }
}

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

  • Не возвращаются таблицы стилей – Убедитесь, что исходный документ действительно содержит CSS (например, Word‑документ со стилизованными таблицами или встроенным HTML).
  • Некорректные URL – Проверьте, что строки префикса заканчиваются соответствующим разделителем (/ или =) для маршрутизации вашего сервера.
  • Проблемы с производительностью – Для очень больших документов рассмотрите обработку таблиц стилей пакетами, чтобы избежать высокого потребления памяти.

Заключение

Обработка CSS‑контента с префиксом с помощью GroupDocs.Editor для .NET проста и мощна. Следуя этим шагам, вы можете handle css prefix, получить необработанный CSS через extract css content и бесшовно интегрировать внешние ресурсы в ваш веб‑рабочий процесс. Исследуйте другие возможности GroupDocs.Editor, такие как конвертация в HTML, извлечение изображений и объединение документов, чтобы получить ещё большую ценность от API.

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

Можно ли использовать GroupDocs.Editor для .NET с другими форматами документов?

Да, GroupDocs.Editor для .NET поддерживает различные форматы документов, включая PDF, Word, Excel и другие.

Доступна ли бесплатная пробная версия GroupDocs.Editor для .NET?

Конечно! Вы можете начать бесплатную пробную версию here.

Как получить временную лицензию для GroupDocs.Editor для .NET?

Вы можете получить временную лицензию here.

Где можно найти подробную документацию по GroupDocs.Editor для .NET?

Подробная документация доступна here.

Какие варианты поддержки доступны для GroupDocs.Editor для .NET?

Поддержку можно получить here.

Дополнительные часто задаваемые вопросы

Q: Можно ли изменить префикс после извлечения CSS?
A: Да. Вызовите GetCssContent снова с другой строкой префикса; метод всегда использует переданные вами значения во время выполнения.

Q: Работает ли это с документами, защищёнными паролем?
A: Да. Укажите пароль в WordProcessingLoadOptions при создании экземпляра Editor.

Q: Можно ли сохранить изменённый CSS обратно в документ?
A: В текущей версии GroupDocs.Editor предоставляется только доступ для чтения к CSS. Чтобы сохранить изменения, вам потребуется заменить оригинальную таблицу стилей с помощью XML‑API документа.

Последнее обновление: 2026-03-06
Тестировано с: GroupDocs.Editor 23.12 for .NET
Автор: GroupDocs