Aracılığıyla paylaş

<dependency> öğesi (ClickOnce dağıtımı)

Yüklenecek uygulamanın sürümünü ve uygulama bildiriminin konumunu tanımlar.

Sözdizimi


      <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>

Öğeler ve öznitelikler

dependency öğesi gereklidir. Öznitelikleri yok. Dağıtım bildiriminde birden çok dependency öğe olabilir.

dependency öğesi genellikle bir ClickOnce uygulamasında bulunan derlemelerde ana uygulama için bağımlılıkları ifade eder. Main.exe uygulamanız DotNetAssembly.dll adlı bir derleme tüketiyorsa, bu derleme bir bağımlılık bölümünde listelenmelidir. Ancak bağımlılık, ortak dil çalışma zamanının belirli bir sürümüne, genel derleme önbelleğindeki (GAC) bir derlemeye veya COM nesnesine bağımlılıklar gibi diğer bağımlılık türlerini de ifade edebilir. Dokunmadan dağıtım teknolojisi olduğundan ClickOnce bu tür bağımlılıkların indirilmesini ve yüklenmesini başlatamaz, ancak belirtilen bağımlılıklardan biri veya daha fazlası yoksa uygulamanın çalışmasını engeller.

Dependentassembly

Gerekli. Bu öğe öğesini assemblyIdentity içerir. Aşağıdaki tabloda, desteklediği öznitelikler gösterilmektedir dependentAssembly .

Öznitelik Açıklama
preRequisite isteğe bağlı. Bu derlemenin GAC'de zaten var olması gerektiğini belirtir. Geçerli değerler: true ve false. ve truebelirtilen derleme GAC'de yoksa, uygulama çalıştırılamaz.
visible isteğe bağlı. Bağımlılıkları dahil olmak üzere en üst düzey uygulama kimliğini tanımlar. Uygulama depolamayı ve etkinleştirmeyi yönetmek için ClickOnce tarafından dahili olarak kullanılır.
dependencyType Gerekli. Bu bağımlılık ile uygulama arasındaki ilişki. Geçerli değerler:

- install. Bileşen, geçerli uygulamadan ayrı bir yüklemeyi temsil eder.
- preRequisite. Bileşen geçerli uygulama için gereklidir.
codebase isteğe bağlı. Uygulama bildiriminin tam yolu.
size isteğe bağlı. Uygulama bildiriminin bayt cinsinden boyutu.

Assemblyıdentity

Gerekli. Bu öğe, öğesinin dependentAssembly alt öğesidir. öğesinin assemblyIdentity içeriği, ClickOnce uygulama bildiriminde açıklananla aynı olmalıdır. Aşağıdaki tabloda öğesinin öznitelikleri gösterilmektedir assemblyIdentity .

Öznitelik Açıklama
Name Gerekli. Uygulamanın adını tanımlar.
Version Gerekli. Uygulamanın sürüm numarasını aşağıdaki biçimde belirtir: major.minor.build.revision
publicKeyToken Gerekli. Uygulamanın veya derlemenin imzalandığı ortak anahtarın SHA-1 karmasının son 8 baytını temsil eden 16 karakterlik onaltılık dizeyi belirtir. İmza için kullanılan ortak anahtar 2048 bit veya daha büyük olmalıdır.
processorArchitecture Gerekli. Mikro işlemciyi belirtir. Geçerli değerler x86 32 bit Windows ve IA64 64 bit Windows içindir.
Language isteğe bağlı. Derlemenin iki parçalı dil kodlarını tanımlar. Örneğin, İngilizce (ABD) anlamına gelen EN-US. Varsayılan değer: neutral. Bu öğe ad alanındadır asmv2 .
type isteğe bağlı. Windows yan yana yükleme teknolojisiyle geriye dönük uyumluluk için. İzin verilen tek değerdir win32.

hash

hash öğesi, öğesinin file isteğe bağlı bir alt öğesidir. öğesinin hash özniteliği yok.

ClickOnce, dağıtımdan sonra dosyaların hiçbirinin değiştirilmediğinden emin olmak için bir uygulamadaki tüm dosyaların algoritmik karmasını güvenlik denetimi olarak kullanır. hash Öğesi dahil değilse, bu denetim gerçekleştirilmeyecektir. Bu nedenle, öğesinin atlanması hash önerilmez.

dsig:Dönüşümler

dsig:Transforms öğesi, öğesinin hash gerekli bir alt öğesidir. öğesinin dsig:Transforms özniteliği yok.

dsig:Transform

dsig:Transform öğesi, öğesinin dsig:Transforms gerekli bir alt öğesidir. Aşağıdaki tabloda öğesinin öznitelikleri gösterilmektedir dsig:Transform .

Öznitelik Açıklama
Algorithm Bu dosyanın özetini hesaplamak için kullanılan algoritma. Şu anda ClickOnce tarafından kullanılan tek değerdir urn:schemas-microsoft-com:HashTransforms.Identity.

dsig:DigestMethod

dsig:DigestMethod öğesi, öğesinin hash gerekli bir alt öğesidir. Aşağıdaki tabloda öğesinin öznitelikleri gösterilmektedir dsig:DigestMethod .

Öznitelik Açıklama
Algorithm Bu dosyanın özetini hesaplamak için kullanılan algoritma. Şu anda ClickOnce tarafından kullanılan tek değerdir http://www.w3.org/2000/09/xmldsig#sha1.

dsig:DigestValue

dsig:DigestValue öğesi, öğesinin hash gerekli bir alt öğesidir. öğesinin dsig:DigestValue özniteliği yok. Metin değeri, belirtilen dosyanın hesaplanan karmasıdır.

Açıklamalar

Dağıtım bildirimleri genellikle uygulama bildiriminin adını ve sürümünü tanımlayan tek assemblyIdentity bir öğeye sahiptir.

Örnek 1

Aşağıdaki kod örneği, ClickOnce dağıtım bildirimindeki bir dependency öğeyi gösterir.

<!-- 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>

Örnek 2

Aşağıdaki kod örneği, GAC'de zaten yüklü olan bir derlemeye bağımlılığı belirtir.

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

Örnek 3

Aşağıdaki kod örneği, ortak dil çalışma zamanının belirli bir sürümüne bağımlılığı belirtir.

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

Örnek 4

Aşağıdaki kod örneği bir işletim sistemi bağımlılığını belirtir.

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

Ayrıca bkz.

  • Last updated on