<deployment> Prvek (Nasazení ClickOnce)

Článek
08/11/2011

Určuje atributy používané pro nasazení aktualizací a jejich vystavení systému.

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

Atributy a prvky

deployment Je vyžadován prvek a je urn:schemas-microsoft-com:asm.v1 oboru názvů. Prvek má následující atributy.

Atribut	Popis
install	Povinné. Určuje, zda tato aplikace definuje přítomnost v nabídce Start systému Windows a v aplikaci Ovládacích panelů 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á prvek subscription.
minimumRequiredVersion	Nepovinné. Určuje minimální verzi této aplikace, kterou lze spustit na klientském počítači. Pokud je číslo verze aplikace menší než číslo verze 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. Pokud je atribut install false, musí být nastavena minimumRequiredVersion.
mapFileExtensions	Nepovinné. Výchozí hodnota false. Pokud je True, všechny soubory v nasazení musí mít příponu .deploy. ClickOnce odstraní tuto příponu z těchto souborů ihned poté, co je stáhne webového serveru. Pokud publikujete aplikaci pomocí Visual Studio, ta automaticky přidá tuto příponu ke všem souborům. Tento parametr umožňuje stáhnout všechny soubory v rámci nasazení ClickOnce z webového serveru, který blokuje přenos souborů končících "nebezpečnými" příponami jako třeba .exe.
disallowUrlActivation	Nepovinné. Výchozí hodnota false. Pokud je true, zabraňuje nainstalované aplikaci, aby byla spouštěna klepnutím na adresu URL nebo zadáním adresy URL do aplikace Internet Explorer. Pokud není přítomen atribut install, je tento atribut ignorován.
trustURLParameters	Nepovinné. Výchozí hodnota false. Pokud je true umožňuje adrese URL obsahovat parametry řetězce dotazů, které jsou předány aplikaci podobně, jako jsou argumenty příkazového řádku předávány aplikacím příkazového řádku. Další informace naleznete v tématu Postupy: Načtení informací o řetězec dotazu v aplikaci Online technologie ClickOnce. Pokud je atribut disallowUrlActivation true, trustUrlParameters musí být vyloučeny z manifestu nebo explicitně nastaveny na false.

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

předplatné

Nepovinné. Obsahuje prvek update. Prvek subscription neobsahuje žádné atributy. Pokud prvek subscription neexistuje, aplikace ClickOnce nebude nikdy kontrolovat aktualizace. Pokud má atribut install prvku deployment hodnotu false, prvek subscription je ignorován, protože aplikace ClickOnce, která je spuštěna ze sítě používá vždy nejnovější verzi.

aktualizace

Povinné. Tento prvek je podřízeným prvkem subscription a obsahuje buď prvek beforeApplicationStartup nebo expiration. beforeApplicationStartup a expiration nelze zadat současně v stejném manifestu nasazení.

Prvek update neobsahuje žádné atributy.

beforeApplicationStartup

Nepovinné. Tento prvek je podřízený prvku update a nemá žádné atributy. Pokud prvek beforeApplicationStartup existuje, bude aplikace blokována, pokud bude ClickOnce vyhledávat aktualizace, pokud je klient v režimu online. Pokud tento element neexistuje, ClickOnce nejprve vyhledá aktualizace na základě hodnot určených pro prvek expiration. beforeApplicationStartup a expiration nelze zadat současně v stejném manifestu nasazení.

Vypršení platnosti

Nepovinné. Tento prvek je podřízeným prvkem update a nemá podřízené prvky . beforeApplicationStartup a expiration nelze zadat současně v stejném manifestu nasazení. Jakmile dojde ke kontrole aktualizace a rozpoznání aktualizované verze, nová verze se uloží v mezipaměti dokud běží stávající verze. Nové verze ja pak nainstalována při příštím spuštění aplikace ClickOnce.

Prvek expiration podporuje následující atributy.

Atribut	Popis
maximumAge	Povinné. Určuje, jak stará by měla současná aktualizace být, aby aplikace provedla kontrolu aktualizace. Určená časová jednotka je dána atributem unit.
unit	Povinné. Označuje jednotku času pro maximumAge. Platné jednotky jsou hodiny, dny a týdny.

deploymentProvider

Pro rozhraní .NET Framework 2.0, je tento prvek vyžadován, pokud manifest nasazení obsahuje oddíl subscription. Pro rozhraní .NET Framework 3.5 a novější je tento prvek nepovinný a výchozí nastavení bude podle serveru a cesty soubor, kde byl manifest nasazení nalezen.

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

Atribut	Popis
codebase	Povinné. Určuje umístění, jako identifikátor URI manifestu nasazení, který slouží k aktualizaci aplikace ClickOnce. Tento prvek také umožňuje předávání umístění aktualizace instalaci založené na disku CD. Musí být platný identifikátor URI.

Poznámky

Můžete nakonfigurovat váši aplikaci ClickOnce pro vyhledání aktualizací při spuštění, po spuštění nebo nikdy nevyhledávat aktualizace. Chcete-li vyhledat aktualizace při spuštění, ověřte, zda prvek beforeApplicationStartup existuje v prvku update. Chcete-li vyhledávat aktualizace po spuštění, ověřte, zda prvek expiration existuje v prvku update a že jsou poskytovány intervaly aktualizací.

Chcete-li zakázat zjišťování aktualizací, odeberte prvek subscription. Pokud zadáte v manifestu nasazení nikdy nekontrolovat aktualizace, můžete ručně zkontrolovat aktualizace pomocí metody CheckForUpdate.

Další informace o tom, jak se deploymentProvider týká aktualizace, naleznete v tématu Výběr strategie aktualizace ClickOnce.

Příklady

Následující příklad kódu ukazuje prvek deployment v manifestu nasazení ClickOnce. Příklad používá prvek deploymentProvider 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é

Odkaz

Manifest nasazení ClickOnce

Sdílet prostřednictvím