<dependency> , element (aplikacja ClickOnce)

Artykuł
04/16/2024

Identyfikuje zależność platformy lub zestawu wymaganą dla aplikacji.

Składnia


      <dependency>
   <dependentOS
      supportURL
      description
   >
      <osVersionInfo>
         <os
            majorVersion
            minorVersion
            buildNumber
            servicePackMajor
            servicePackMinor
            productType
            suiteType
         />
      </osVersionInfo>
   </dependentOS>
   <dependentAssembly
      dependencyType
      allowDelayedBinding
      group
      codeBase
      size
   >
      <assemblyIdentity
         name
         version
         processorArchitecture
         language
      >
         <hash>
            <dsig:Transforms>
               <dsig:Transform
                  Algorithm
            />
            </dsig:Transforms>
            <dsig:DigestMethod />
            <dsig:DigestValue>
            </dsig:DigestValue>
    </hash>

      </assemblyIdentity>
   </dependentAssembly>
</dependency>

Elementy i atrybuty

Element dependency jest wymagany. Może istnieć wiele wystąpień dependency w tym samym manifeście aplikacji.

Element dependency nie ma atrybutów i zawiera następujące elementy podrzędne.

zależny systemOS

Opcjonalny. osVersionInfo Zawiera element . dependentOS Elementy i dependentAssembly wykluczają się wzajemnie: jeden lub drugi musi istnieć dla dependency elementu, ale nie oba te elementy.

dependentOS program obsługuje następujące atrybuty.

Atrybut	opis
`supportUrl`	Opcjonalny. Określa adres URL pomocy technicznej dla platformy zależnej. Ten adres URL jest wyświetlany użytkownikowi, jeśli zostanie znaleziona wymagana platforma.
`description`	Opcjonalny. Opisuje w postaci czytelnej dla człowieka system operacyjny opisany przez `dependentOS` element .

osVersionInfo

Wymagany. Ten element jest elementem podrzędnym dependentOS elementu i zawiera os element . Ten element nie ma atrybutów.

Os

Wymagany. Ten element jest elementem podrzędnym osVersionInfo elementu. Ten element ma następujące atrybuty.

Atrybut	opis
`majorVersion`	Wymagane. Określa numer wersji głównej systemu operacyjnego.
`minorVersion`	Wymagany. Określa numer wersji pomocniczej systemu operacyjnego.
`buildNumber`	Wymagany. Określa numer kompilacji systemu operacyjnego.
`servicePackMajor`	Wymagany. Określa numer główny dodatku Service Pack systemu operacyjnego.
`servicePackMinor`	Opcjonalny. Określa pomocniczą liczbę systemu operacyjnego dodatku Service Pack.
`productType`	Opcjonalny. Identyfikuje wartość typu produktu. Prawidłowe wartości to `server`, `workstation` i `domainController`. Na przykład dla systemu Windows 10 ta wartość atrybutu to `workstation`.
`suiteType`	Opcjonalny. Określa pakiet produktów dostępny w systemie lub typ konfiguracji systemu. Prawidłowe wartości to `backoffice`, `bladeprofessionaldatacenterhomesmallbusinessenterprise`, , `smallbusinessRestricted`, i .`terminal` Na przykład w przypadku systemu Windows 2000 Professional ta wartość atrybutu to `professional`.

dependentAssembly

Opcjonalny. assemblyIdentity Zawiera element . dependentOS Elementy i dependentAssembly wykluczają się wzajemnie: jeden lub drugi musi istnieć dla dependency elementu, ale nie oba te elementy.

dependentAssembly ma następujące atrybuty.

Atrybut	opis
`dependencyType`	Wymagane. Określa typ zależności. Prawidłowe wartości to `prerequisite` i `install`. Zestaw `install` jest instalowany w ramach aplikacji ClickOnce. Zestaw `prerequisite` musi znajdować się w globalnej pamięci podręcznej zestawów (GAC), zanim będzie można zainstalować aplikację ClickOnce.
`allowDelayedBinding`	Wymagany. Określa, czy zestaw można załadować programowo w czasie wykonywania.
`group`	Opcjonalny. `dependencyType` Jeśli atrybut jest ustawiony na `install`, wyznacza nazwaną grupę zestawów, które instalują się tylko na żądanie. Aby uzyskać więcej informacji, zobacz Przewodnik: pobieranie zestawów na żądanie przy użyciu interfejsu API wdrażania ClickOnce przy użyciu Projektant. Jeśli jest ustawiona `framework` wartość i `dependencyType` atrybut ma wartość `prerequisite`, wyznacza zestaw w ramach programu .NET Framework. Globalna pamięć podręczna zestawów (GAC) nie jest sprawdzana w przypadku tego zestawu podczas instalowania w programie .NET Framework 4 i nowszych wersjach.
`codeBase`	Wymagane, gdy `dependencyType` atrybut jest ustawiony na `install`. Ścieżka do zestawu zależnego. Może być ścieżką bezwzględną lub ścieżką względną względem bazy kodu manifestu. Ta ścieżka musi być prawidłowym identyfikatorem URI, aby manifest zestawu był prawidłowy.
`size`	Wymagane, gdy `dependencyType` atrybut jest ustawiony na `install`. Rozmiar zestawu zależnego w bajtach.

Assemblyidentity

Wymagany. Ten element jest elementem podrzędnym dependentAssembly elementu i ma następujące atrybuty.

Atrybut	opis
`name`	Wymagane. Identyfikuje nazwę aplikacji.
`version`	Wymagany. Określa numer wersji aplikacji w następującym formacie: `major.minor.build.revision`
`publicKeyToken`	Opcjonalny. Określa 16-znakowy ciąg szesnastkowy, który reprezentuje ostatnie 8 bajtów `SHA-1` wartości skrótu klucza publicznego, w ramach którego jest podpisana aplikacja lub zestaw. Klucz publiczny używany do podpisywania wykazu musi mieć wartość 2048 bitów lub więcej.
`processorArchitecture`	Opcjonalny. Określa procesor. Prawidłowe wartości dotyczą `x86` 32-bitowego systemu Windows i `I64` 64-bitowego systemu Windows.
`language`	Opcjonalny. Identyfikuje dwa częściowe kody języków, takie jak EN-US, zestawu.

hash

Element hash jest opcjonalnym elementem podrzędnym assemblyIdentity elementu. Element hash nie ma atrybutów.

Funkcja ClickOnce używa algorytmowego skrótu wszystkich plików w aplikacji jako sprawdzenia zabezpieczeń, aby upewnić się, że żadne z plików nie zostało zmienione po wdrożeniu. hash Jeśli element nie zostanie uwzględniony, to sprawdzenie nie zostanie wykonane. W związku z tym pominięcie hash elementu nie jest zalecane.

dsig:Transforms

Element dsig:Transforms jest wymaganym elementem podrzędnym hash elementu. Element dsig:Transforms nie ma atrybutów.

dsig:Transform

Element dsig:Transform jest wymaganym elementem podrzędnym dsig:Transforms elementu. Element dsig:Transform ma następujące atrybuty.

Atrybut	opis
`Algorithm`	Algorytm używany do obliczania skrótu dla tego pliku. Obecnie jedyną wartością używaną przez ClickOnce jest `urn:schemas-microsoft-com:HashTransforms.Identity`.

dsig:DigestMethod

Element dsig:DigestMethod jest wymaganym elementem podrzędnym hash elementu. Element dsig:DigestMethod ma następujące atrybuty.

Atrybut	opis
`Algorithm`	Algorytm używany do obliczania skrótu dla tego pliku. Obecnie jedyną wartością używaną przez ClickOnce jest `http://www.w3.org/2000/09/xmldsig#sha1`.

dsig:DigestValue

Element dsig:DigestValue jest wymaganym elementem podrzędnym hash elementu. Element dsig:DigestValue nie ma atrybutów. Jego wartość tekstowa to obliczony skrót dla określonego pliku.

Uwagi

Wszystkie zestawy używane przez aplikację muszą mieć odpowiedni dependency element. Zestawy zależne nie zawierają zestawów, które muszą być wstępnie zainstalowane w globalnej pamięci podręcznej zestawów jako zestawy platformy.

Przykład

Poniższy przykład kodu ilustruje dependency elementy w manifeście aplikacji ClickOnce. Ten przykład kodu jest częścią większego przykładu podanego dla tematu Manifest aplikacji ClickOnce.

<dependency>
  <dependentOS>
    <osVersionInfo>
      <os
        majorVersion="4"
        minorVersion="10"
        buildNumber="0"
        servicePackMajor="0" />
    </osVersionInfo>
  </dependentOS>
</dependency>
<dependency>
  <dependentAssembly
    dependencyType="preRequisite"
    allowDelayedBinding="true">
    <assemblyIdentity
      name="Microsoft.Windows.CommonLanguageRuntime"
      version="4.0.20506.0" />
  </dependentAssembly>
</dependency>

<dependency>
  <dependentAssembly
    dependencyType="install"
    allowDelayedBinding="true"
    codebase="MyApplication.exe"
    size="4096">
    <assemblyIdentity
      name="MyApplication"
      version="1.0.0.0"
      language="neutral"
      processorArchitecture="x86" />
    <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>DpTW7RzS9IeT/RBSLj54vfTEzNg=</dsig:DigestValue>
    </hash>
  </dependentAssembly>
</dependency>

Udostępnij za pośrednictwem