إضافة معالجات إلى إضافة العناصر ومربعات حوار مشروع جديد باستخدام ملفات.Vsdir
ملف VSDir هو ملف نصي بملحق.vsdir التي تقوم بإنشائها بتقديم معلومات حول كيفية عرض عناصر الخاصة به إلى إضافة عنصر و مربعات حوار مشروع جديد. تتضمن أسماء عناصر، والترتيب الذي تظهر به، و الرمز المعروض معها. يمكنك تغيير أي من هذه عناصر. يتم استخدام ملفات VSDir لإضافة قوالب جديدة أو معالجات إلى إضافة عنصر و مربعات حوار مشروع جديد.
هناك هو لا يوجد ملف VSDir الافتراضي. إذا كان ملف هو موجودة، ثم Visual Studioقراءة عليه وإضافة محتوياتها إلى مربعات حوار. إذا كان ملف هو غير موجودة، ثم dهوplay الافتراضي للقوالب ومعالجات. يمكنك الحصول على ملفات VSDir متعددة في الدليل مفرد و سيتم إضافة كافة محتوياتها إلى مربعات حوار. بشكل عام، VSDir ملف مفرد يحتوي على سجلات متعددة معالجات المجلدات والقوالب. كل سجل في ملف مفصولة بواسطة حرف السطر الجديد. حرف توجيه الإخراج (|) لفصل حقول الموجودة في كل سجل. أي حقل اختياري لأي هناك هو لا توجد بيانات ذات معنى تحتوي على قيمة صفر (0) أو مسافة كحرف نائب. السلاسل التي تم إدخالها في حقول لا تتطلب علامتي اقتباس حولها.
مكونات ملف VSDir
فيما يلي أمثلة VSDir ملفات. اﻷول مراجع معالج مفرد، الذي تم إنشاؤه في موضوع الإرشادات التفصيلية: إنشاء معالج:
MyNewWizard.vsz| |A New Wizard|1|My New Wizard|C:\Addins\MyNewWizard\MyNewWizard\bin\Debug| | |MyNewWizard99
المثال التالي VSDir ملف تشير إلى عدد من المعالج.vsz ملف s، بالإضافة إلى معلومات أخرى ذات صلة التي تتعلق بكل معالج (كما هو موضح لاحقاً في هذا الموضوع). هذه مختلفة عن VSDir السابق الملفات التي كانت مرجع سلاسل كأرقام المعرف مورد، والسلاسل الحرفية لا. كما أنها من استخدام المعرفات العامة الفريدة GUID إلى تشير إلى مكتبات الارتباط الديناميكي.
..\..\Projects\csharp building blocks\BusinessFacade.vsz|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|#5015|10|#5022|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|127|0|Project
..\..\Projects\csharp building blocks\BusinessRules.vsz|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|#5016|20|#5023|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|128|0|Project
..\..\Projects\csharp building blocks\DataAccess.vsz|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|#5017|30|#5024|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|129|0|Project
..\..\Projects\csharp building blocks\SystemFrameworks.vsz|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|#5018|40|#5025|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|130|0|Project
..\..\Projects\csharp building blocks\WebService.vsz|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|#5019|50|#5026|{FAE04EC1-301F-11d3-BF4B-00C04F79EFBC}|4547|1|WebService|Web
..\..\Projects\csharp building blocks\WebUI.vsz|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|#5020|60|#5027|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|131|1|WebUI|web
..\..\Projects\csharp building blocks\WinUI.vsz|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|#5021|70|#5028|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|132|0|Project
يمكن أن يتم تعيين حقول التالية لكل سجل في ملف VSDir:
الحقل |
المعنى |
|---|---|
RelPathName |
مطلوبة. اسم الملف.vsz معالج's، مثل Myمعالج.vsz، نسبة إلى Visual Studioيثّبت الدليل. |
{clsidPackage} |
اختياري. المعرف الفريد عمومي "الذي يمثل أحد منتجات (مثل كـ Visual C++) ذلك h كـ الذي يحتوي مكتبة الارتباط الديناميكي على ترجمة موارد. عادة th هو الحقل هو فارغاً لملفات VSDir تتوافق مع معالجات جهة خارجية. |
LocalizedName |
اختياري. هذا هو اسم معالج localizable أو قالب والاسم الذي يظهر في صندوق الحوار إضافة عنصر. يمكن أن تكون سلسلة "أو" معرّف مورد هو النموذج #ResID. |
SortPriority |
مطلوبة. عدد صحيح يمثل "ترتيب فرز" و "الأفضلية النسبية للمعالج، مع قيد واحد أعلى. على سبيل المثال، إذا كان ترتيب هو عنصر هو "1"، ثم ترتيب هو تظهر بجانب الأخرى 1s ويتاخر عن الجميع 2s أو أقل. |
الوصف |
مطلوبة. وصف localizable للقالب أو معالج كما سيظهر في صندوق الحوار إضافة عنصر صندوق عند العنصر هو المحدد. يمكن أن تكون سلسلة "أو" معرّف مورد هو النموذج #ResID. يتم تطبيقه فقط على ملفات قالب، وليس المجلدات. |
DLLPath أو {clsidPackage} |
مطلوبة. Specifies a كامل مسار إلى a DLL أو EXE ملف, أو a معرّف فريد عالمي of a منتج that has a .dll ملف that يحتوي على an رمز إلى تحميل for the معالج. The رمز هو تم تحميله كـ a مورد خارج of a DLL/EXE ملف بواسطة using the given IconResourceId. This إعداد overrides {clsidPackage}, if specified, for رمز الموقع. يتم تطبيقه فقط على ملفات قالب، وليس المجلدات. |
IconResourceId |
اختياري. A مورد معرّف within the DLL ملف that determines the رمز إلى عرض. If لا رمز هو defined, the بيئة substitutes the الرمز الافتراضي for a ملف مع the same ملحق كـ the العنصر. يتم تطبيقه فقط على ملفات قالب، وليس المجلدات. |
Flags |
اختياري. See Flags وصف و جدول below. يتم تطبيقه فقط على ملفات قالب، وليس المجلدات. |
SuggestedBaseName |
مطلوبة. The الافتراضي اسم for the معالج, displayed في the اسم حقل في the حوار صندوق. This هو either a سلسلة أو a مورد معرّف of the نموذج #ResID. إذا كان الاسم هو البيئة غير فريد، يلحق الاسم بعدد صحيح. For مثال, MyFile.aspx might be تم تغييره إلى MyFile1.aspx. If لا اسم هو provided, then "مشروع" هو used. يتم تطبيقه فقط على ملفات قالب، وليس المجلدات. |
ملاحظات
أي non-مطلوب حقل for which there غير محقق meaningful بيانات should contain a 0 (zero) كـ a عنصر نائب.If لا localized اسم هو provided, the نسبي مسار هو used.
If لا رمز هو defined, the IDE substitutes the الرمز الافتراضي for a ملف مع that ملحق.
If لا suggested الأساس اسم هو provided, "مشروع" هو used.
Flags
مجموعة من الإشارات تمثل باستخدام إلى تمكين أو يعطل اسم وحقول الموقع من ضمن صندوق الحوار إضافة عنصر. أن هو، عندما يحدد مستخدم إضافة عنصر جديد? من قائمة إضافة مشروع بتحديد ما إذا كان اسم وموقع dهوplayed في الجزء القوالب، ولكن علامات تحديد ما إذا كان الاسم والموقع متوفرة للمستخدم.التعيين الالقيمة Flagsإلى مجموع قيم الفردية. أن هو، 33 هو مساوية ل VSDIRFLAG_NonLocalTemplate | VSDIRITEM_DهوableLocationField.
اسم الإشارة
القيمة العشرية
الوصف
VSDIRFLAG_NonLocalTemplate
1
استخدام سلوك واجهة مستخدم غير محلية و حفظ آليات.
VSDIRFLAG_BlankSolution
2
إنشاء حلاً (فارغ) فارغ. لا إنشاء مشروع.
VSDIRFLAG_DisableBrowseButton
4
قم بتعطيل الزر "استعراض" لهذا مشروع أو العنصر.
VSDIRFLAG_DontAddDefExtension
8
يجب عدم إلحاق ملحق افتراضي إلى اسم العنصر. (Th هو إعداد هو غير صالح للمشاريع.)
VSDIRFLAG_DisableLocationField
32
قم بتعطيل الحقل "الموقع" لهذا مشروع أو العنصر.
VSDIRFLAG_DontInitNameField
4096
قم بتهيئة حقل الاسم لهذا مشروع لا أو العنصر مع اسم صالح.
VSDIRFLAG_DisableNameField
8192
قم بتعطيل حقل الاسم لهذا مشروع أو العنصر.
راجع أيضًا:
المهام
كيفية القيام بما يلي: قم بإنشاء إضافة-في
الإرشادات التفصيلية: إنشاء معالج
المبادئ
تكوين ملفات إلى ابدأ.Vsz معالجات