<deployment> , element (wdrożenie ClickOnce)

  • Artykuł

Identyfikuje atrybuty używane do wdrażania aktualizacji i ekspozycji na system.

Składnia


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

Elementy i atrybuty

Element deployment jest wymagany i znajduje się w urn:schemas-microsoft-com:asm.v2 przestrzeni nazw. Element ma następujące atrybuty.

Atrybut opis
install Wymagane. Określa, czy ta aplikacja definiuje obecność w menu Start systemu Windows i w Panel sterowania Dodaj lub Usuń programy aplikacji. Prawidłowe wartości to true i false. Jeśli falsefunkcja ClickOnce będzie zawsze uruchamiać najnowszą wersję tej aplikacji z sieci i nie rozpozna subscription elementu.
minimumRequiredVersion Opcjonalny. Określa minimalną wersję tej aplikacji, która może działać na kliencie. Jeśli numer wersji aplikacji jest mniejszy niż numer wersji podany w manifeście wdrożenia, aplikacja nie zostanie uruchomiona. Numery wersji muszą być określone w formacie N.N.N.N, gdzie N jest niepodpisaną liczbą całkowitą. Jeśli atrybut ma installfalsewartość , minimumRequiredVersion nie można go ustawić.
mapFileExtensions Opcjonalny. Wartość domyślna to false. Jeśli truewszystkie pliki we wdrożeniu muszą mieć rozszerzenie .deploy. Funkcja ClickOnce usunie to rozszerzenie z tych plików zaraz po pobraniu ich z serwera sieci Web. Jeśli opublikujesz aplikację przy użyciu programu Visual Studio, automatycznie doda to rozszerzenie do wszystkich plików. Ten parametr umożliwia pobranie wszystkich plików we wdrożeniu technologii ClickOnce z serwera sieci Web, który blokuje przesyłanie plików kończących się na "niebezpiecznych" rozszerzeniach, takich jak .exe.
disallowUrlActivation Opcjonalny. Wartość domyślna to false. Jeśli trueprogram uniemożliwia uruchomienie zainstalowanej aplikacji, klikając adres URL lub wprowadzając adres URL w przeglądarce. install Jeśli atrybut nie jest obecny, ten atrybut jest ignorowany.
trustURLParameters Opcjonalny. Wartość domyślna to false. Jeśli trueelement zezwala adresowi URL na zawieranie parametrów ciągu zapytania przekazywanych do aplikacji, podobnie jak argumenty wiersza polecenia są przekazywane do aplikacji wiersza polecenia. Aby uzyskać więcej informacji, zobacz How to: Retrieve Query String Information in an Online ClickOnce Application (Instrukcje: pobieranie informacji o ciągu zapytania w aplikacji ClickOnce online).

disallowUrlActivation Jeśli atrybut ma truewartość , trustUrlParameters musi zostać wykluczony z manifestu lub jawnie ustawiony na falsewartość .

Element deployment zawiera również następujące elementy podrzędne.

subskrypcja

Opcjonalny. update Zawiera element . Element subscription nie ma atrybutów. subscription Jeśli element nie istnieje, aplikacja ClickOnce nigdy nie będzie skanować pod kątem aktualizacji. install Jeśli atrybut deployment elementu to false, subscription element jest ignorowany, ponieważ aplikacja ClickOnce uruchamiana z sieci zawsze używa najnowszej wersji.

update

Wymagany. Ten element jest elementem podrzędnym subscription elementu i zawiera beforeApplicationStartup element lub expiration . beforeApplicationStartup nie expiration można określić obu tych elementów w tym samym manifeście wdrożenia.

Element update nie ma atrybutów.

beforeApplicationStartup

Opcjonalny. Ten element jest elementem podrzędnym update elementu i nie ma atrybutów. beforeApplicationStartup Gdy element istnieje, aplikacja zostanie zablokowana po sprawdzeniu dostępności aktualizacji przez aplikację ClickOnce, jeśli klient jest w trybie online. Jeśli ten element nie istnieje, funkcja ClickOnce najpierw przeskanuje aktualizacje na podstawie wartości określonych dla expiration elementu. beforeApplicationStartup nie expiration można określić obu tych elementów w tym samym manifeście wdrożenia.

wygaśnięcie

Opcjonalny. Ten element jest elementem podrzędnym elementu i nie ma elementów podrzędnych update . beforeApplicationStartup nie expiration można określić obu tych elementów w tym samym manifeście wdrożenia. Po zakończeniu sprawdzania aktualizacji i wykryciu zaktualizowanej wersji nowa wersja jest buforowana podczas uruchamiania istniejącej wersji. Nowa wersja zostanie zainstalowana podczas następnego uruchomienia aplikacji ClickOnce.

Element expiration obsługuje następujące atrybuty.

Atrybut opis
maximumAge Wymagane. Określa, jak stara powinna stać się bieżąca aktualizacja przed wykonaniem przez aplikację kontroli aktualizacji. Jednostka czasu jest określana unit przez atrybut .
unit Wymagany. Określa jednostkę czasu dla maximumAgeelementu . Prawidłowe jednostki to hours, daysi weeks.

Deploymentprovider

W przypadku programu .NET Framework 2.0 ten element jest wymagany, jeśli manifest wdrożenia zawiera sekcję subscription . W przypadku programu .NET Framework 3.5 lub nowszego ten element jest opcjonalny i będzie domyślny dla serwera i ścieżki pliku, w której wykryto manifest wdrożenia.

Ten element jest elementem podrzędnym deployment elementu i ma następujący atrybut.

Atrybut opis
codebase Wymagane. Identyfikuje lokalizację jako identyfikator URI (Uniform Resource Identifier) manifestu wdrożenia używanego do aktualizowania aplikacji ClickOnce. Ten element umożliwia również przekazywanie lokalizacji aktualizacji dla instalacji opartych na dyskach CD. Musi być prawidłowym identyfikatorem URI.

Uwagi

Aplikację ClickOnce można skonfigurować do skanowania pod kątem aktualizacji podczas uruchamiania, skanowania pod kątem aktualizacji po uruchomieniu lub nigdy nie sprawdzaj dostępności aktualizacji. Aby przeprowadzić skanowanie pod kątem aktualizacji podczas uruchamiania, upewnij się, że beforeApplicationStartup element istnieje w elemecie update . Aby skanować pod kątem aktualizacji po uruchomieniu, upewnij się, że expiration element istnieje w elemecie update i czy podano interwały aktualizacji.

Aby wyłączyć sprawdzanie dostępności aktualizacji, usuń subscription element. Po określeniu w manifeście wdrożenia, aby nigdy nie skanować pod kątem CheckForUpdate aktualizacji, nadal można ręcznie sprawdzić dostępność aktualizacji przy użyciu metody .

Uwaga

Klasy ApplicationDeployment i interfejsy API w System.Deployment.Application przestrzeni nazw nie są obsługiwane w wersjach .NET Core i .NET 5 i nowszych. W programie .NET 7 jest obsługiwana nowa metoda uzyskiwania dostępu do właściwości wdrażania aplikacji. Aby uzyskać więcej informacji, zobacz Access ClickOnce deployment properties in .NET (Uzyskiwanie dostępu do właściwości wdrożenia ClickOnce na platformie .NET). Platforma .NET 7 nie obsługuje odpowiedników metod ApplicationDeployment.

Aby uzyskać więcej informacji na temat sposobu, w jaki dostawca deploymentProvider odnosi się do aktualizacji, zobacz Wybieranie strategii aktualizacji ClickOnce.

Przykłady

Poniższy przykład kodu ilustruje deployment element w manifeście wdrożenia ClickOnce. W przykładzie deploymentProvider użyto elementu , aby wskazać preferowaną lokalizację aktualizacji.

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

Zobacz też