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

قم بتعريف الإصدار الخاص بالتطبيق لتثبيت وموقع الملف الظاهر للتطبيق.

<dependency> 
   <dependentAssembly
      preRequisite
      visible
      dependencyType
      codeBase
      size
   > 
      <assemblyIdentity 
         name 
         version 
         publicKeyToken 
         processorArchitecture 
         language
         type
      /> 
      <hash>
         <dsig:Transforms>
            <dsig:Transform
                Algorithm
            />
         </dsig:Transforms>
         <dsig:DigestMethod />
         <dsig:DigestValue>
         </dsig:DigestValue>
      </hash>

   </dependentAssembly> 
</dependency>

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

العنصر dependency مطلوب. لا يحتوي على أي سمات. بيان توزيع يمكن أن يحتوي عدة dependencyالعناصر.

dependencyيعبر العنصر عادة عن التبعيات للتطبيق الأساسي في تجميعات في ClickOnceتطبيق. إذا كان تطبيق الخاص بك Main.exe يستهلك تجميع تسمى DotNetAssembly.dll، ثم يجب سرد هذا التجميع في مقطع تبعية. تبعية، ومع ذلك، يمكن أيضا عن أنواع غير ذلك من التبعيات، مثل التبعيات على محدد الإصدار من وقت تشغيل اللغة العامة، على تجميع في ذاكرة التخزين المؤقتة للتجميع العمومي (GAC)، أو على كائن COM. لأن ذلك هو التقنية اللمس لا النشر، ClickOnceلا تبدأ بتحميل وتثبيت هذه الأنواع من التبعيات، لكنه منع تطبيق من العمل إذا واحد أو المزيد تبعيات المحدد ليس exهوt.

dependentAssembly

مطلوبة. وهذا عنصر يحتوي على assemblyIdentityعنصر. يلي جدول يعرض السمات dependentAssemblyاعتماد.

السمة	الوصف
preRequisite	اختياري. تحديد أن هذا تجميع يجب أن موجودة مسبقاً في GAC. صالح قيم are صواب و خطأ. إذا كان صحيحاً ، والتجميع المحدد غير موجود في GAC، فشل تطبيق إلى تشغيل.
visible	اختياري. قم بتعريف هوية تطبيق ذي المستوى الأعلى، بما في ذلك تبعياته. استخدامها داخليا بواسطة ClickOnceإلى إدارة sإلىrage تطبيق والتنشيط.
dependencyType	مطلوبة. العلاقة بين هذه تبعية و تطبيق. القيم الصالحة هي : يثّبت. مكوّن يمثل تثبيت منفصل من تطبيق الحالي. المتطلبات الأساسية. مكون هو المطلوبة من قبل تطبيق الحالي.
codebase	اختياري. مسار الكامل إلى بيان تطبيق.
size	اختياري. الحجم تطبيق بيان، بالبايت.

assemblyIdentity

مطلوبة. Th هو عنصر هو تابع ل dependentAssemblyالعنصر. المحتوى assemblyIdentityيجب أن تكون هي نفسها كـ المذكورة في ClickOnceبيان تطبيق. يعرض الجدول التالي السمات assemblyIdentityعنصر.

السمة	الوصف
Name	مطلوبة. قم بتعريف اسم تطبيق.
Version	مطلوبة. تعيين رقم الإصدار تطبيق، بالتنسيق التالي: رئيسي.ثانوي.بنية.المراجعة
publicKeyToken	مطلوبة. تعين سلسلة الست عشرية 16 حرف آخر 8 وحدات البايت لتجزئة SHA-1 مفتاح عام الذي يمثل تطبيق أو تجميع هو موقعة. استخدام مفتاح عام إلى يجب تسجيل 2048 بت أو أكبر.
processorArchitecture	مطلوبة. تعيين المعالج. قيم الصالحة هي x86 ل Windows 32 بت و IA64 ل Windows من النوع 64 بت.
Language	اختياري. قم بتعريف رموز اللغة الثاني جزءا من تجميع. ل مثال، EN-US، والتي تشير إلى للإنكليزية (الولايات المتحدة). و القيمة الافتراضية هي حيادي. Th هو عنصر هو في asmv2مساحة الاسم.
type	اختياري. للخلف بالتوافق مع Windows جنبا إلى جنب يثّبت التقنية. مسموح فقط قيمة هو win32 .

تجزئة

hashعنصر هو فرع اختيارية fileالعنصر. العنصر hash لا يملك أي سمات.

ClickOnceيستخدم تجزئة algorithmic الجميع الملفات الموجودة في تطبيق ما مثل مالية فحص للتأكد من أن أي من الملفات التي تم تغييرها بعد توزيع. إذا hashعنصر هو عدم مُضمن هذا الاختيار لن يتم تنفيذ. لذلك، يتم حذف hashعنصر غير مستحسن.

dsig:Transforms

dsig:Transformsعنصر هو فرع مطلوبة hashالعنصر. العنصر dsig:Transforms لا يملك أي سمات.

dsig:Transform

dsig:Transformعنصر هو فرع مطلوبة dsig:Transformsالعنصر. يعرض الجدول التالي السمات dsig:Transformعنصر.

السمة	الوصف
Algorithm	الخوارزمية المستخدمة في حساب في ملخص لهذه ملف. حاليا فقط القيمة المستخدمة بواسطة ClickOnceهو com:HashTransforms.الهوية urn: رسوم تخطيطية-microsoft- .

dsig:DigestMethod

dsig:DigestMethodعنصر هو فرع مطلوبة hashالعنصر. يعرض الجدول التالي السمات dsig:DigestMethodعنصر.

السمة	الوصف
Algorithm	الخوارزمية المستخدمة في حساب في ملخص لهذه ملف. حاليا فقط القيمة المستخدمة بواسطة ClickOnceهو http://www.w3.org/2000/09/xmldsig#sha1 .

dsig:DigestValue

dsig:DigestValueعنصر هو فرع مطلوبة hashالعنصر. العنصر dsig:DigestValue لا يملك أي سمات. القيمة نص الخاص به هو التجزئة المحسوبة للملف المحدد.

ملاحظات

توزيع بيانات عادة ما تحتوي على واحدة assemblyIdentityالعناصر التي تعرف الاسم والإصدار من ملف بيان تطبيق.

مثال

يظهر المثال تعليمات برمجية التالي dependencyالعنصر في ClickOnceتوزيع البيان.

<!-- Identify the assembly dependencies -->
<dependency>
  <dependentAssembly dependencyType="install" allowDelayedBinding="true" codebase="MyApplication.exe" size="16384">
    <assemblyIdentity name="MyApplication" version="0.0.0.0" cultural="neutral" processorArchitecture="msil" />
    <hash>
      <dsig:Transforms>
        <dsig:Transform Algorithm="urn:schemas-microsoft-com:HashTransforms.Identity" />
      </dsig:Transforms>
      <dsig:DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1" />
       <dsig:DigestValue>YzXYZJAvj9pgAG3y8jXUjC7AtHg=</dsig:DigestValue>
    </hash>
  </dependentAssembly>
</dependency>

التالي تعليمات برمجية يحدد المثال تبعية تشغيل تجميع مثبتة بالفعل في GAC.

<dependency>
  <dependentAssembly dependencyType="preRequisite" allowDelayedBinding="true">
    <assemblyIdentity name="GACAssembly" version="1.0.0.0" language="neutral" processorArchitecture="msil" />
  </dependentAssembly>
</dependency>

التالي تعليمات برمجية يحدد المثال تبعية على الإصدار محدد من وقت تشغيل اللغة العامة.

<dependency>
  <dependentAssembly dependencyType="preRequisite" allowDelayedBinding="true">
    <assemblyIdentity name="Microsoft.Windows.CommonLanguageRuntime" version="2.0.50215.0" />
  </dependentAssembly>
</dependency>

تحديد مثال التعليمة البرمجية التالية تبعية لنظام التشغيل.

<dependency>
   <dependentOS supportUrl="https://www.microsoft.com" description="Microsoft Windows Operating System">
      <osVersionInfo>
         <os majorVersion="4" minorVersion="10" />
      </osVersionInfo>
   </dependentOS>
</dependency>

راجع أيضًا:

المرجع

ClickOnce Deployment Manifest

<dependency> Element (ClickOnce Application)