Udostępnij za pośrednictwem

<dependency> Element (wdrażania ClickOnce)

  • Artykuł

Identyfikuje wersję aplikacji, aby zainstalować i lokalizacji manifest aplikacji.

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

Elementy i atrybuty

dependency Element jest wymagany.Ma on nie atrybutów.Manifest wdrożenia może mieć wiele dependency elementy.

dependency Element zwykle wyraża zależności dla głównej aplikacji zestawów zawartych w ClickOnce aplikacji.Jeśli aplikacja Main.exe używa zestawu o nazwie DotNetAssembly.dll, Zgromadzenia, muszą być wymienione w sekcji zależność.Zależność, jednak można również wyrazić innych typów współzależności, takie jak zależności w określonej wersji środowiska common language runtime, zespół w globalna pamięć podręczna zestawów (GAC) lub obiektu COM.Ponieważ technologia rozmieszczania bezobsługowego, ClickOnce nie zainicjuj pobieranie i instalowanie tych typów współzależności, ale wyklucza uruchomieniu aplikacji, jeśli jeden lub więcej określonych zależności nie istnieje.

dependentAssembly

Wymagane.Element ten zawiera assemblyIdentity element.W poniższej tabeli przedstawiono atrybuty dependentAssembly obsługuje.

Atrybut

Opis

preRequisite

Opcjonalne.Określa, że ten zestaw powinien już istnieją w pamięci podręcznej GAC.Prawidłowe wartości to true i false.Jeśli truei nie ma określonego zestawu w pamięci podręcznej GAC, aplikacja nie działa.

visible

Opcjonalne.Określa tożsamość aplikacji najwyższego poziomu, włącznie z jego zależności.Używane wewnętrznie przez ClickOnce zarządzać Magazyn aplikacji i aktywacji.

dependencyType

Wymagane.Relacje między tej zależności i aplikacji.Prawidłowe wartości to:

  • Zainstaluj.Składnik reprezentuje oddzielnych instalacji z bieżącej aplikacji.

  • Wstępne.Składnik jest wymagany przez bieżącą aplikację.

codebase

Opcjonalne.Pełna ścieżka do manifest aplikacji.

size

Opcjonalne.Rozmiar manifest aplikacji, w bajtach.

element assemblyIdentity

Wymagane.Ten element jest elementem podrzędnym dependentAssembly element.Zawartość assemblyIdentity musi być taka sama, jak opisano w ClickOnce manifest aplikacji.W poniższej tabeli przedstawiono atrybuty assemblyIdentity element.

Atrybut

Opis

Name

Wymagane.Identyfikuje nazwę aplikacji.

Version

Wymagane.Określa numer wersji aplikacji, w następującym formacie: major.minor.build.revision

publicKeyToken

Wymagane.Określa ciąg szesnastkowy 16 znaków, który reprezentuje ostatniego 8 bajtów mieszania SHA-1 klucza publicznego, pod którym aplikacji lub zestawu jest podpisany.Klucz publiczny używany do podpisywania musi być 2048 bitów lub większej.

processorArchitecture

Wymagane.Określa mikroprocesora.Prawidłowe wartości to x 86 dla 32-bitowego systemu Windows i IA64 dla 64-bitowego systemu Windows.

Language

Opcjonalne.Określa kody języków dwóch części zgromadzenia.Na przykład EN-US, który stoi na angielski (USA).Wartością domyślną jest neutralne.Ten element znajduje się w asmv2 obszaru nazw.

type

Opcjonalne.Do tyłu zgodność z side-by-side systemu Windows zainstaluj technologii.Tylko wartości dozwolone jest win32.

hash

hash Element jest opcjonalne dziecko file element.hash Element nie posiada żadnych atrybutów.

ClickOnceużywa algorytmiczny mieszania wszystkie pliki w aplikacji w celu sprawdzenia zabezpieczeń w celu zapewnienia, że żaden z plików zostały zmienione po wdrożeniu.Jeśli hash element nie jest włączone, nie można wykonać tego wyboru. W związku z tym, pomijając hash element nie jest zalecane.

DSIG:TRANSFORMS

dsig:Transforms Element jest wymagany dziecko hash element.dsig:Transforms Element nie posiada żadnych atrybutów.

DSIG:Transform

dsig:Transform Element jest wymagany dziecko dsig:Transforms element.W poniższej tabeli przedstawiono atrybuty dsig:Transform element.

Atrybut

Opis

Algorithm

Algorytm używany do obliczania szyfrowanego dla tego pliku.Obecnie tylko wartość używana przez ClickOnce jest urn: schemas-microsoft-com:HashTransforms.Identity.

DSIG:DigestMethod

dsig:DigestMethod Element jest wymagany dziecko hash element.W poniższej tabeli przedstawiono atrybuty dsig:DigestMethod element.

Atrybut

Opis

Algorithm

Algorytm używany do obliczania szyfrowanego dla tego pliku.Obecnie tylko wartość używana przez ClickOnce jest http://www.w3.org/2000/09/xmldsig#sha1.

DSIG:DigestValue

dsig:DigestValue Element jest wymagany dziecko hash element.dsig:DigestValue Element nie posiada żadnych atrybutów.Jego wartość tekstowa jest obliczony skrót dla określonego pliku.

Uwagi

Manifesty rozmieszczania zwykle posiada jeden assemblyIdentity element, który identyfikuje nazwa i wersja manifest aplikacji.

Przykład

Następujący kod pokazuje przykład dependency element w ClickOnce wdrażania manifestu.

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

Poniższy przykład kodu określa zależność w zestawie zainstalowanym w pamięci podręcznej GAC.

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

Poniższy przykład kodu określa zależność w określonej wersji aparatu plików wykonywalnych języka wspólnego.

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

Poniższy przykład kodu określa zależność systemu operacyjnego.

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

Zobacz też

Informacje

Manifest wdrażania ClickOnce

<dependency> Element (ClickOnce aplikacji)