الموارد في تنسيق الملف Text
يمكن أن تحتوي الملفات النصية (.txt) على موارد السلسلة فقط. طالما أنك تقوم بحفظ ملف نصي بشكل مناسب, يمكنك تحديد سلاسل باستخدام أحد أنظمة الترميز الثلاثة: UTF-16 في ترتيب البايت endian صغيرة أو big-endian، أو UTF-8. على سبيل المثال، إذا كنت ترغب في حفظ واستخدام أحرف اللغة الألمانية، احفظ الملف النصي استخدام UTF-8 ترميز بدلاً من استخدام ANSI معينة تعليمات برمجية الصفحة. للحصول على مزيد من المعلومات حول استخدام الترميزات، راجع Unicode في .NET Framework .
.gif "ملاحظة") ملاحظة |
|---|
يعامل مولد ملف الموارد(Resgen.exe) الملفات كـ UTF-8 بشكل افتراضي.ليقوم Resgen.exe بالتعرف على ملف تم ترميزه باستخدام UTF-16، يجب عليك تضمين علامة ترتيب بايت Unicode من نوع (U+FEFF) في بداية الملف. |
بالإضافة إلى إدخالات السلاسل، الملفات النصية يمكن أن تحتوي على تعليقات. لا يوجد أي حد لعدد الإدخالات التي يمكنك تضمينها في ملف نصي. يمكنك أيضاً استخدام مساحة بيضاء (خطوط فارغة) خلال الملف لتسهيل القراءة. يجب ملاحظة أن المساحات المحيطة لا يتم تضمينها مع أي خط فردي عندما يتم تخزينها أو استردادها. بالإضافة إلى ذلك، يتم السماح بسلسلة فارغة.
و إذا كان الملف النصي يحتوي على أسماء الموارد المتكررة فإن Resgen.exe سوف يرسل تحذير و يتجاهل الأسماء المكررة.
يصف الجدول التالي أنواع الإدخال للملفات النصية.
Entry |
الوصف |
|---|---|
;تعليقات |
يمكنك اختيارياً تضمين تعليقات خلال ملف نصي. يجب أن تستهل التعليق بفاصلة منقوطة أو علامة الترقيم (#). التعليقات تساعد على شرح كيفية تنظيم الموارد. على سبيل المثال، قد تقوم بتنظيم الموارد في ملف معين عن طريق وضع تسمية لها مع تعليقات مثل ;exceptions و ;general messages و ;text labels و ;form titles و ما إلى ذلك. لاحظ أن هذه التعليقات تُفقد إذا قمت بتحويل ملف .txt إلى ملف .resources. |
name = value |
يجب تحديد موارد السلسلة كزوج إدخالات الاسم/القيمة، حيث يكون الاسم سلسلة تصف المورد و القيمة هي سلسلة المورد التي سيتم إرجاعها عندما يتم استرداد الاسم بواسطة أسلوب ResourceManager.GetString. الاسم و القيمة يجب أن تكون مفصولة بعلامة يساوي (=). على سبيل المثال، Msg1 = Hello, and Welcome! لا يمكن أن تحتوي القيمة على أحرف السطر الجديد، و لكن يمكنك استخدام أحرف الإلغاء الخاصة بنمط لغة C مثل \n ليمثل سطر جديد \t ليمثل علامة تبويب. بالإضافة إلى ذلك، يتم السماح بسلسلة فارغة. فعلى سبيل المثال: MyEmptyString=. |
بمجرد إضافة كافة الإدخالات المطلوبة إلى ملف نصي، قم بحفظه باسم مناسب و امتداد .txt.
| ملاحظة |
|---|
لا تستخدم ملفات الموارد لتخزين كلمات المرور أو معلومات الأمان الهامة أو البيانات الخاصة. |
لا يمكنك تضمين ملف .txt في تجميع. يجب عليك تحويل ملف .txt الخاص بك إلى ملف .resources باستخدام منشئ ملف الموارد (Resgen.exe). لمزيد من المعلومات، راجع الموارد في تنسيق الملف .Resources .