<توزيع> عنصر (ClickOnce توزيع)

Identifies the السمات used for the توزيع of تحديثات و exposure إلى the النظام.

<deployment 
   install
   minimumRequiredVersion
   mapFileExtensions
   disallowUrlActivation
   trustUrlParameters
> 
   <subscription> 
         <update> 
            <beforeApplicationStartup/> 
            <expiration
               maximumAge
               unit
            />
         </update>  
   </subscription> 
   <deploymentProvider 
      codebase 
   /> 
</deployment>

السمات والعناصر

The deployment عنصر هو مطلوب و هو في the urn:schemas-microsoft-com:asm.v1 مساحة الاسم. العنصر له السمات التالية.

السمة	الوصف
install	مطلوبة. Specifies whether هذا تطبيق defines a presence تشغيل the Windows يبدأ قائمة و في the لوحة التحكم إضافة أو إزالة البرامج تطبيق. صالح قيم are صواب و خطأ. إذا خاطئة ، ClickOnceستعمل دائماً أحدث إصدار هذا تطبيق من شبكة الاتصال، ولن تتعرف على subscriptionالعنصر.
minimumRequiredVersion	اختياري. Specifies the الحد الأدنى الإصدار of هذا تطبيق that can run تشغيل the العميل. If the الإصدار رقم of the تطبيق هو أصغر من the الإصدار رقم supplied في the بيان التوزيع, the تطبيق will not تشغيل. الإصدار أرقام must be specified في the تنسيق N.N.N.N, الموقع N هو an عدد صحيح بلا إشارة. If the install سمة هو خطأ, minimumRequiredVersion must not be التعيين.
mapFileExtensions	اختياري. افتراضيات إلى خطأ. إذا صحيحاً ، كافة الملفات في توزيع، يجب أن يكون ملحق.نشر. ClickOnceشريط هذا الملحق إيقاف هذه الملفات بمجرد أن يتم تحميله من خادم ويب. If you ينشر your تطبيق بواسطة using Visual Studio, it automatically adds this ملحق إلى الجميع ملفات. This معلمة allows الجميع the ملفات within a ClickOnce توزيع إلى be downloaded من a ويب الخادم that blocks transmission of ملفات الإنهاء في "غير آمن" ملحقات such كـ .exe.
disallowUrlActivation	اختياري. افتراضيات إلى خطأ. If صواب, prevents an installed تطبيق من being started بواسطة clicking the URL أو entering the URL في إنترنت مستكشف. If the install سمة ليس موجود, this سمة هو ignored.
trustURLParameters	اختياري. افتراضيات إلى خطأ. If صواب, allows the URL إلى contain استعلام سلسلة معلمات that are passed في the تطبيق, much مثل الأمر-خط الوسيطات are passed إلى a الأمر-خط تطبيق. لمزيد من المعلومات، راجع كيفية: استرداد سلسلة الاستعلام عن معلومات في تطبيق ClickOnce. If the disallowUrlActivation سمة هو صواب, trustUrlParameters must either be مستثنى من the بيان, أو بوضوح التعيين إلى خطأ.

The deployment عنصر also يحتوي على the following فرع عناصر.

الاشتراك

اختياري. يحتوي على العنصر update . العنصر subscription لا يملك أي سمات. If the subscription عنصر غير موجود, the ClickOnce تطبيق will ‏‏مطلقاً مسح ضوئي for تحديثات. If the install سمة of the deployment عنصر هو خطأ, the subscription عنصر هو ignored, because a ClickOnce تطبيق that هو launched من the شبكة دوماً uses the latest الإصدار.

تحديث

مطلوبة. Th هو عنصر هو فرع ل subscriptionالعنصر ويحتوي على أي beforeApplicationStartupأو expirationالعنصر. beforeApplicationStartup and expiration cannot both be specified in the same deployment manifest.

العنصر update لا يملك أي سمات.

beforeApplicationStartup

اختياري. Th هو عنصر هو فرع ل updateالعنصر ويحتوي على السمات لا. عند beforeApplicationStartupexهوts العنصر، سوف يكون تطبيق حظر متى ClickOnceبالتحقق من التحديثات، إذا كان العميل هو عبر الإنترنت. إذا كان هذا العنصر غير موجود، ClickOnceسوف أول الفحص لتحديثات استناداً إلى قيم المحددة expirationالعنصر. beforeApplicationStartup and expiration cannot both be specified in the same deployment manifest.

انتهاء الصلاحية

اختياري. Th هو عنصر هو فرع ل updateعنصر، وقد لا يوجد اﻷطفال. beforeApplicationStartup and expiration cannot both be specified in the same deployment manifest. عند ظهور الاختيار تحديث والحصول على إصدار محدث هو تخزين، الإصدار الجديد مؤقتاً أثناء تشغيل الإصدار exهوting. الإصدار الجديد ثم يقوم بتثبيت تشغيل الإطلاق التالية في ClickOnceتطبيق.

expirationيعتمد عنصر السمات التالية.

السمة	الوصف
maximumAge	مطلوبة. تعرف على كيفية القديم التحديث الحالي يجب أن تصبح قبل أن يقوم تطبيق بتحديث فحص. الوحدة الزمنية هو تحديد بواسطة unitالسمة.
unit	مطلوبة. يحدد الوحدة الزمنية ل maximumAge. صالح وحدات areساعات, أيام, و weeks.

deploymentProvider

ل.NET Framework 2.0، هذا العنصر مطلوب في حالة النشر بيان يحتوي subscriptionمقطع. 3.5 إطار عمل.NET والإصدارات الأحدث، هذا العنصر اختيارية, وسيتم الافتراضي إلى مسار الملقم والملف الذي النشر بيان تم اكتشافها.

Th هو عنصر هو فرع ل deploymentالعنصر والسمة التالية.

السمة	الوصف
codebase	مطلوبة. قم بتعريف الموقع، كمعرّف موقع المعلومات (URI)، من النشر بيان يستخدم لتحديث ClickOnceتطبيق. وهذا عنصر يسمح أيضا لإعادة توجيه مواقع? تحديث التثبيتات المستندة إلى CD. يجب أن يكون URI صحيحة.

ملاحظات

يمكنك تكوين جهاز ClickOnceتطبيق إلى بحثاً عن التحديثات عند بدء التشغيل، تفحص التحديثات بعد بدء التشغيل، أو عدم فحص من وجود تحديثات. إلى مسح ضوئي عن التحديثات عند بدء التشغيل، ضمان beforeApplicationStartupعنصر موجود ضمن updateالعنصر. إلى البحث عن تحديثات بعد بدء التشغيل، قم بالتأكد من أن expirationعنصر موجود ضمن updateالعنصر، والتي يتم توفيرها من فواصل التحديثات الزمنية.

إلى تعطيل البحث عن التحديثات، قم بإزالة subscriptionالعنصر. عند تحديد في النشر بيان لعدم الفحص عن التحديثات، يمكنك مازال يدوياً تحقق من التحديثات باستخدام CheckForUpdateالأسلوب.

للحصول على مزيد من المعلومات حول كيفية ارتباط deploymentProvider إلى التحديثات، راجع اختيار استراتيجية ClickOnce التحديث.

أمثلة

يوضح المثال تعليمات برمجية التالي deploymentالعنصر في ClickOnceنشر بيان. يستخدم المثال deploymentProviderعنصر للإشارة إلى الموقع تحديث المفضل.

<deployment install="true" minimumRequiredVersion="2.0.0.0" mapFileExtension="true" trustUrlParameters="true">
    <subscription>
      <update>
        <expiration maximumAge="6" unit="hours" />
      </update>
    </subscription>
    <deploymentProvider codebase="http://www.adatum.com/MyApplication.application" />
  </deployment>

راجع أيضًا:

المرجع

ClickOnce Deployment Manifest