Sdílet prostřednictvím

<element deployment> (nasazení ClickOnce)

  • Článek

Identifikuje atributy používané k nasazení aktualizací a vystavení systému.

Syntaxe


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

Prvky a atributy

Prvek deployment je povinný a je v urn:schemas-microsoft-com:asm.v2 oboru názvů. Element má následující atributy.

Atribut Popis
install Požadováno. Určuje, zda tato aplikace definuje přítomnost v nabídce Start systému Windows a v aplikaci Ovládací panely Přidat nebo odebrat programy. Platné hodnoty jsou true a false. Pokud false, ClickOnce bude vždy spouštět nejnovější verzi této aplikace ze sítě a nerozpozná subscription prvek.
minimumRequiredVersion Nepovinné. Určuje minimální verzi této aplikace, která se dá spustit v klientovi. Pokud je číslo verze aplikace menší než číslo verze zadané v manifestu nasazení, aplikace se nespustí. Čísla verzí musí být zadána ve formátu N.N.N.N, kde N je celé číslo bez znaménka. install Pokud je falseatribut , minimumRequiredVersion nesmí být nastaven.
mapFileExtensions Nepovinné. Výchozí hodnota falseje . Pokud truemusí mít všechny soubory v nasazení příponu .deploy. ClickOnce odstraní toto rozšíření z těchto souborů, jakmile je stáhne z webového serveru. Pokud publikujete aplikaci pomocí sady Visual Studio, automaticky přidá toto rozšíření do všech souborů. Tento parametr umožňuje stažení všech souborů v nasazení ClickOnce z webového serveru, který blokuje přenos souborů končících na "nebezpečné" přípony, jako je .exe.
disallowUrlActivation Nepovinné. Výchozí hodnota falseje . Pokud truezabráníte spuštění nainstalované aplikace kliknutím na adresu URL nebo zadáním adresy URL do prohlížeče. install Pokud atribut neexistuje, bude tento atribut ignorován.
trustURLParameters Nepovinné. Výchozí hodnota falseje . Pokud trueumožňuje adrese URL obsahovat parametry řetězce dotazu, které jsou předány do aplikace, podobně jako argumenty příkazového řádku jsou předány do aplikace příkazového řádku. Další informace naleznete v tématu Postupy: Načtení informací o řetězci dotazu v aplikaci Online ClickOnce.

Pokud je trueatribut , trustUrlParameters musí být buď vyloučen z manifestu, nebo explicitně nastaven na false.disallowUrlActivation

Prvek deployment obsahuje také následující podřízené prvky.

předplatné

Nepovinné. update Obsahuje prvek. Element subscription nemá žádné atributy. subscription Pokud prvek neexistuje, aplikace ClickOnce nebude nikdy vyhledávat aktualizace. install Pokud je falseatribut deployment elementu , subscription prvek je ignorován, protože aplikace ClickOnce spuštěná ze sítě vždy používá nejnovější verzi.

update

Povinný: Tento prvek je podřízený prvek subscription a obsahuje buď prvek beforeApplicationStartup , nebo expiration prvek. beforeApplicationStartup a expiration nelze je zadat ve stejném manifestu nasazení.

Element update nemá žádné atributy.

beforeApplicationStartup

Nepovinné. Tento prvek je podřízený prvek update a nemá žádné atributy. beforeApplicationStartup Pokud prvek existuje, aplikace bude blokována, když ClickOnce kontroluje aktualizace, pokud je klient online. Pokud tento prvek neexistuje, ClickOnce nejprve vyhledá aktualizace na základě hodnot zadaných expiration pro prvek. beforeApplicationStartup a expiration nelze je zadat ve stejném manifestu nasazení.

vypršení platnosti

Nepovinné. Tento prvek je podřízený update prvek a nemá žádné podřízené položky. beforeApplicationStartup a expiration nelze je zadat ve stejném manifestu nasazení. Když dojde ke kontrole aktualizace a zjistí se aktualizovaná verze, nová verze se ukládá do mezipaměti při spuštění stávající verze. Nová verze se pak nainstaluje na další spuštění aplikace ClickOnce.

Element expiration podporuje následující atributy.

Atribut Popis
maximumAge Požadováno. Určuje, jak staré by se měla aktuální aktualizace stát před provedením kontroly aktualizace aplikace. Jednotka času je určena atributem unit .
unit Povinný: Určuje jednotku času pro maximumAge. Platné jednotky jsou hours, daysa weeks.

Deploymentprovider

Pro rozhraní .NET Framework 2.0 se tento prvek vyžaduje, pokud manifest nasazení obsahuje subscription oddíl. Pro rozhraní .NET Framework 3.5 a novější je tento prvek volitelný a ve výchozím nastavení se použije cesta k serveru a souboru, ve kterém byl zjištěn manifest nasazení.

Tento prvek je podřízený prvek deployment a má následující atribut.

Atribut Popis
codebase Požadováno. Identifikuje umístění jako identifikátor URI (Uniform Resource Identifier) manifestu nasazení, který se používá k aktualizaci aplikace ClickOnce. Tento prvek také umožňuje předávání umístění aktualizací pro instalace založené na cd. Musí to být platný identifikátor URI.

Poznámky

Aplikaci ClickOnce můžete nakonfigurovat tak, aby hledala aktualizace při spuštění, hledala aktualizace po spuštění nebo nikdy nekontroluje aktualizace. Chcete-li vyhledat aktualizace při spuštění, ujistěte se, že beforeApplicationStartup prvek existuje pod elementem update . Chcete-li vyhledat aktualizace po spuštění, ujistěte se, že expiration prvek existuje pod update elementem a že jsou k dispozici intervaly aktualizace.

Pokud chcete zakázat kontrolu aktualizací, odeberte subscription prvek. Když v manifestu nasazení zadáte, že se aktualizace nikdy nenajdou, můžete aktualizace vyhledat ručně pomocí CheckForUpdate této metody.

Poznámka:

Třída ApplicationDeployment a rozhraní API v System.Deployment.Application oboru názvů nejsou podporovány v .NET Core a .NET 5 a novějších verzích. V .NET 7 se podporuje nová metoda přístupu k vlastnostem nasazení aplikace. Další informace naleznete v tématu Access ClickOnce vlastnosti nasazení v .NET. .NET 7 nepodporuje ekvivalent metod ApplicationDeployment.

Další informace o tom, jak deploymentProvider souvisí s aktualizacemi, naleznete v tématu Volba strategie aktualizace ClickOnce.

Příklady

Následující příklad kódu znázorňuje deployment prvek v manifestu nasazení ClickOnce. Příklad používá deploymentProvider prvek k označení upřednostňovaného umístění aktualizace.

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

Viz také