CSS 處理
在本完整指南中，您將學習 將 CSS 注入 HTML 與 GroupDocs.Editor for .NET，如何 提取 CSS，添加 CSS 前綴，以及在多種文件格式中管理 CSS 內容。無論您是構建內容管理系統、自動化報告產生器，或是遷移管道，控制樣式表的提取與注入可確保視覺結果一致，免除手動複製貼上。
快速解答
- 「提取 CSS」是什麼意思？ 從文件中提取連結或嵌入的樣式表資料，轉為獨立的 CSS 字串。
- 為什麼要添加 CSS 前綴？ 為避免在合併多個來源的內容時發生樣式衝突。
- 哪個 API 方法可取得外部 CSS？
Editor.GetExternalCssAsync（或其同步對應方法）。 - 我需要授權嗎？ 生產環境使用需具備有效的 GroupDocs.Editor 授權。
- 支援的平台？ .NET Framework 4.6+、.NET Core 3.1+、.NET 5/6/7。
如何提取 CSS？
Editor 類別是 GroupDocs.Editor 中載入與操作文件的主要入口點。
使用 Editor 類別載入文件，然後呼叫返回樣式表文字的專用方法。
直接答案： 呼叫 await editor.GetExternalCssAsync()（或 editor.GetExternalCss()），API 會以純文字字串返回完整的外部 CSS，準備進一步操作或注入。此單一呼叫可省去手動 HTML 解析，並保證每一條規則—包括媒體查詢與 @font‑face 聲明—都能如原始來源般完整捕獲。
Editor.GetExternalCssAsync 是非同步方法，會以純文字字串返回文件的外部 CSS 內容。
取得 CSS 字串後，您可以將其儲存、修改，或注入至其他 HTML 文件。
添加 CSS 前綴
為每個選擇器加上前綴可防止在同一頁面上將提取的樣式表與其他樣式表合併時發生意外覆寫。
直接答案： 使用簡單的字串取代或 CSS 解析器庫，於每條規則前加上唯一識別碼（例如 .myDoc-），產生的樣式表僅影響屬於注入文件的元素。此方法輕量—對於 200 KB 的樣式表通常在 5 ms 以下—且在批次操作中具備良好擴展性。
管理 CSS 內容
除了提取與加前綴之外，您可能還需要合併多個 CSS 區塊、壓縮它們，或在渲染或轉換前將其重新注入文件。GroupDocs.Editor 的 API 允許您將 CSS 視為普通字串處理，全面掌控排序、壓縮與重新應用。
- 合併： 使用換行分隔符串接多個 CSS 字串。
- 壓縮： 使用第三方壓縮工具（例如 NUglify）將大小減少最高可達 70 %。
- 重新注入：
SetCssAsync方法在渲染前將 CSS 字串套用至已載入的文件。呼叫await editor.SetCssAsync(modifiedCss)可在渲染為 PDF、影像或 HTML 前套用已編輯的樣式表。
為何使用 GroupDocs.Editor 處理 CSS？
GroupDocs.Editor 支援 30 多種文件格式（包括 HTML、DOCX、PPTX 與 EPUB），且可處理高達 500 MB 的檔案而無需將整個檔案載入記憶體，提供比手動解析方法 30 % 的速度提升。此函式庫保證提取的 CSS 與原始渲染相符，提供一致的 API 以進行前綴與重新注入，且完全在伺服器端執行—消除客戶端效能瓶頸。
取得外部 CSS 內容
您是否在從文件中提取外部 CSS 內容時感到困難？我們的教學《取得外部 CSS 內容》使用 GroupDocs.Editor for .NET 為您提供完整說明。了解如何將此功能無縫整合至您的應用程式，並簡化文件管理工作流程。告別手動提取，迎接自動化解決方案。
欲了解更多資訊，請參閱 Get External CSS Content 與 Handle CSS Content with Prefix。
使用前綴處理 CSS 內容
準備將您的 CSS 內容管理技能提升至新層次嗎？探索我們使用 GroupDocs.Editor for .NET 的教學《使用前綴處理 CSS 內容》。無論您是新手還是資深開發者，此步驟式指南皆提供處理 CSS 內容的工具與知識，讓您有效管理。立即提升文件管理工作流程。
常見使用情境
- 內容遷移： 從舊版 HTML 或 DOCX 檔案提取樣式，加入前綴，並注入新 CMS 模板。
- 動態報告產生： 即時產生 HTML 報告，注入符合企業品牌的自訂樣式表，然後轉換為 PDF。
- 多租戶 SaaS 平台： 透過自動為提取的 CSS 加前綴，將每個租戶的樣式隔離，防止跨租戶的視覺洩漏。
疑難排解技巧
- 樣式表遺失： 確認來源文件包含
<link rel="stylesheet">或<style>區塊；否則GetExternalCssAsync會回傳空字串。 - 大型檔案： 若文件超過 200 MB，請啟用串流模式 (
EditorOptions.EnableStreaming = true) 以降低記憶體使用量。 - 編碼問題： 若非 ASCII 字元出現亂碼，請在載入文件前設定
EditorOptions.Encoding = Encoding.UTF8。
常見問題
Q: 我可以從受密碼保護的文件中提取 CSS 嗎？
A: 可以。初始化編輯器時提供文件密碼，提取方法即可正常運作。
Q: 添加 CSS 前綴會影響效能嗎？
A: 前綴操作僅是簡單的字串處理，即使對大型樣式表也幾乎不增加額外負擔。
Q: 哪些文件格式支援外部 CSS 提取？
A: 支援引用外部樣式表的 HTML、DOCX 與 PPTX 檔案。
Q: 可以將修改過的 CSS 重新注入文件嗎？
A: 當然可以。編輯 CSS 字串後，您可使用 Editor.SetCssAsync 方法在渲染或轉換前套用變更。
Q: 我需要單獨處理媒體查詢嗎？
A: 不需要。媒體查詢已包含在提取的 CSS 字串中，會自動保留。
最後更新： 2026-09-16
測試環境： GroupDocs.Editor 23.12 for .NET
作者： GroupDocs
