تحرير مستندات النص العادي باستخدام GroupDocs.Editor لـ .NET

المقدمة

إذا كنت بحاجة إلى تحرير النص العادي بسرعة وموثوقية في تطبيق .NET، فإن GroupDocs.Editor لـ .NET هو الأداة التي تقوم بالعمل الشاق. يدعم هذا API أكثر من 30 تنسيق مستند، ويمكنه التعامل مع ملفات تصل إلى 500 ميغابايت، ويسمح لك بالتلاعب بالنص دون تحميل الملف بالكامل في الذاكرة. في هذا البرنامج التعليمي ستتعلم كيفية تحميل ملف txt، قص المسافات الزائدة في النهاية، تحويل المسافات البادئة، ضبط الترميز الصحيح، وأخيرًا حفظ المحتوى المعدل مرة أخرى على القرص. هل أنت مستعد للتطبيق العملي؟ هيا نبدأ!

إجابات سريعة

• ما هي الخطوة الأولى لتحرير ملف txt؟ قم بتحميل الملف باستخدام Editor باستخدام المسار أو الدفق المتاح لديك.
• هل يمكنني تغيير ترميز الملف أثناء التحرير؟ نعم – يتيح لك TxtSaveOptions تحديد UTF‑8 أو UTF‑16 أو أي ترميز مخصص.
• كيف يمكنني إزالة المسافات الزائدة في نهاية كل سطر؟ استرجع النص، استدعِ TrimEnd() على كل سطر، واكتب النتيجة مرة أخرى.
• هل GroupDocs.Editor مجاني للتجربة؟ نسخة تجريبية كاملة الوظائف لمدة 30 يومًا متاحة من صفحة الإصدارات.
• ما إصدارات .NET المدعومة؟ .NET Framework 4.6+، .NET Core 3.1+، و .NET 5/6/7.

ما هو تحرير النص العادي؟

تحرير النص العادي يعني تغيير الأحرف داخل ملف .txt بسيط برمجيًا — إضافة، حذف، أو إعادة تنسيق النص — مع الحفاظ على الترميز الأصلي للملف ونمط فواصل الأسطر. قد تشمل المهام قص الفراغات، توحيد نهايات الأسطر، تحديث قيم الإعدادات، أو إدراج محتوى مُولد. يجب أن تظل العملية تجعل الملف قابلًا للقراءة بواسطة أي محرر نصوص قياسي وتحافظ على أي بيانات وصفية موجودة مثل علامات BOM.

لماذا نستخدم GroupDocs.Editor لتحرير النص العادي؟

يعالج GroupDocs.Editor الملفات بطريقة تدفقية، مما يعني أنه يمكنه تحرير ملف سجل بحجم 300 ميغابايت باستخدام أقل من 50 ميغابايت من الذاكرة RAM. تدعم المكتبة 50+ تنسيق إدخال وإخراج، وتكتشف تلقائيًا أنماط فواصل الأسطر (CR، LF، CRLF)، وتوفر خيارات مدمجة لـ قص المسافات الزائدة في النهاية وتحويل المسافات البادئة دون الحاجة إلى كتابة محللات مخصصة.

المتطلبات المسبقة

• بيئة تطوير .NET – Visual Studio 2022 أو VS Code مع امتداد C#.
• GroupDocs.Editor لـ .NET – قم بتنزيله من صفحة الإصدارات GroupDocs.Editor for .NET.
• معرفة أساسية بـ C# – يجب أن تكون مرتاحًا مع عمليات إدخال/إخراج الملفات ومعالجة السلاسل.
• محرر نصوص (اختياري) – لتفقد ملفات المصدر؛ يُنصح باستخدام VS Code.
• للاستخدام التفصيلي، راجع التوثيق.
• يمكنك أيضًا تصفح صفحة الإصدارات العامة.

كيفية تحرير النص العادي خطوة بخطوة

حمّل الملف، حرّر محتواه، واحفظه مرة أخرى — كل ذلك في أقل من عشر أسطر من الشيفرة. الأقسام التالية تقودك عبر كل مرحلة مع شروحات واضحة.

الخطوة 1: الحصول على مسار ملف TXT الإدخال

أولاً، قرّر ما إذا كنت ستعمل باستخدام مسار ملف فعلي أو تدفق ذاكرة. استخدام المسار هو النهج الأكثر بساطة للتطوير المحلي.

using System.Collections.Generic;
using System.IO;
using GroupDocs.Editor.Formats;
using GroupDocs.Editor.HtmlCss.Resources;
using GroupDocs.Editor.Options;

الخطوة 2: إنشاء مثيل Editor

Editor هو الفئة الرئيسية التي تقوم بتحميل المستند وتوفر إمكانيات التحرير.

string inputFilePath = "YourSampleDocument.txt";

الخطوة 3: إنشاء خيارات تحرير TXT

TxtEditOptions يضبط كيفية تحليل وتحرير ملفات النص العادي، مما يتيح لك تحديد الترميز وقواعد معالجة المسافات.

using (Editor editor = new Editor(inputFilePath))
{

الخطوة 4: إنشاء مثيل EditableDocument

EditableDocument يمثل النسخة الموجودة في الذاكرة من المستند المحمّل، بما في ذلك نصه وأي موارد مرتبطة.

    TextEditOptions editOptions = new TextEditOptions
    {
        Encoding = System.Text.Encoding.UTF8,
        RecognizeLists = true,
        LeadingSpaces = TextLeadingSpacesOptions.ConvertToIndent,
        TrailingSpaces = TextTrailingSpacesOptions.Trim
    };

الخطوة 5: تحرير محتوى المستند

استرجع النص الأصلي، طبّق أي عمليات سلاسل تحتاجها (مثل الاستبدال، القص، تغيير الحالة)، واحفظ النتيجة مرة أخرى في EditableDocument.

    EditableDocument beforeEdit = editor.Edit(editOptions);

الخطوة 6: إنشاء EditableDocument بالمحتوى المحدث

بعد تحويل النص، أنشئ EditableDocument جديد يحتوي على السلسلة المعدلة ومجموعة الموارد الأصلية.

    string originalTextContent = beforeEdit.GetContent();
    string updatedTextContent = originalTextContent.Replace("text", "EDITED text");
    List<IHtmlResource> allResources = beforeEdit.AllResources;

الخطوة 7: إنشاء خيارات حفظ WordProcessing

WordProcessingSaveOptions يحدد الإعدادات لحفظ المستند بتنسيق متوافق مع Word مثل DOCX أو DOCM.

    EditableDocument afterEdit = EditableDocument.FromMarkup(updatedTextContent, allResources);

الخطوة 8: إنشاء خيارات حفظ TXT

TxtSaveOptions يحدد كيفية كتابة ملف النص العادي المعدل، بما في ذلك الترميز، الحفاظ على نهايات الأسطر، ومعالجة تنسيق الجداول.

    WordProcessingSaveOptions wordSaveOptions = new WordProcessingSaveOptions(WordProcessingFormats.Docm)
    {
        Locale = System.Globalization.CultureInfo.GetCultureInfo("en-GB")
    };

الخطوة 9: إعداد مسارات الإخراج

استخرج دليل الإخراج من مسار ملف الإدخال، ثم أنشئ أسماء الملفات الكاملة لنتائج DOCX و TXT.

    TextSaveOptions txtSaveOptions = new TextSaveOptions
    {
        Encoding = System.Text.Encoding.UTF8,
        PreserveTableLayout = true
    };

الخطوة 10: حفظ المستند المعدل

أخيرًا، استدعِ editor.Save مرتين — مرة بخيارات WordProcessing ومرة أخرى بخيارات TXT — لإنتاج كلا التنسيقين في عملية واحدة.

    string outputWordPath = Path.Combine(Path.GetDirectoryName(inputFilePath), Path.GetFileNameWithoutExtension(inputFilePath) + ".docm");
    string outputTxtPath = Path.Combine(Path.GetDirectoryName(inputFilePath), Path.GetFileNameWithoutExtension(inputFilePath) + ".txt");

المشكلات الشائعة والحلول

• المسافات الزائدة لا تزال بعد التحرير – تأكد من ضبط TxtEditOptions.TrimTrailingSpaces إلى true قبل تحميل المستند.
• الترميز غير صحيح في الملف المحفوظ – تحقق من أن TxtSaveOptions.Encoding يطابق صفحة الترميز المطلوبة (مثال: Encoding.UTF8).
• الملفات الكبيرة تسبب استثناء OutOfMemoryException – استخدم API التدفق (Editor.Load(Stream)) بدلاً من التحميل من مسار ملف للحفاظ على استهلاك الذاكرة منخفضًا.

الأسئلة المتكررة

س: ما تنسيقات الملفات التي يدعمها GroupDocs.Editor لـ .NET؟
ج: تدعم المكتبة أكثر من 50 تنسيقًا، بما في ذلك DOCX، TXT، HTML، PDF، و markdown، مما يتيح لك تحريرها وتحويلها بينها بسلاسة.

س: كيف يمكنني الحصول على نسخة تجريبية مجانية من GroupDocs.Editor لـ .NET؟
ج: قم بتنزيل النسخة التجريبية من صفحة الإصدارات.

س: هل يمكنني شراء ترخيص مؤقت للاختبار؟
ج: نعم، الترخيصات المؤقتة متاحة عبر صفحة شراء GroupDocs.

س: أين يمكنني العثور على الدعم إذا واجهت مشاكل؟
ج: أفضل مكان هو منتدى الدعم الرسمي – زر منتدى دعم GroupDocs.Editor.

س: هل هناك توثيق مفصل للسيناريوهات المتقدمة؟
ج: بالتأكيد. المرجع الكامل موجود على صفحة توثيق GroupDocs.Editor.

الخلاصة

لقد أصبحت الآن متمكنًا من كيفية تحرير النص العادي باستخدام GroupDocs.Editor لـ .NET — تحميل ملف txt، قص المسافات، تحويل المسافات البادئة، ضبط الترميز المناسب، وحفظ النتيجة بصيغتي TXT و DOCX. تتيح لك هذه القدرة أتمتة تنظيف ملفات السجلات، إنشاء ملفات إعدادات في الوقت الفعلي، أو بناء خطوط معالجة نصية مخصصة دون الحاجة إلى إعادة اختراع العجلة. استكشف ميزات إضافية مثل المعالجة الدفعية وتحويل المستندات بزيارة التوثيق الرسمي.

آخر تحديث: 2026-08-10
تم الاختبار مع: GroupDocs.Editor 23.11 لـ .NET
المؤلف: GroupDocs

    editor.Save(afterEdit, outputWordPath, wordSaveOptions);
    editor.Save(afterEdit, outputTxtPath, txtSaveOptions);
}
System.Console.WriteLine("Document editing process completed successfully!");

الدروس ذات الصلة

• دروس تحميل المستندات باستخدام GroupDocs.Editor لـ .NET
• دروس حفظ وتصدير المستندات لـ GroupDocs.Editor .NET
• دروس تحرير النص العادي ومستندات DSV لـ GroupDocs.Editor .NET