Språk

<distributionselement> (ClickOnce-distribution)

Identifierar de attribut som används för distribution av uppdateringar och exponering för systemet.

Syntax


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

Element och attribut

Elementet deployment krävs och finns i urn:schemas-microsoft-com:asm.v2 namnområdet. Elementet har följande attribut.

Attribute Description
install Required. Anger om det här programmet definierar en närvaro på Windows Start-menyn och i programmet ovládací panel Lägg till eller ta bort program. Giltiga värden är true och false. Om falsekör ClickOnce alltid den senaste versionen av det här programmet från nätverket och känner inte igen elementet subscription .
minimumRequiredVersion Optional. Anger den lägsta versionen av det här programmet som kan köras på klienten. Om programmets versionsnummer är mindre än det versionsnummer som anges i distributionsmanifestet körs inte programmet. Versionsnummer måste anges i formatet N.N.N.N, där N är ett osignerat heltal. Om attributet install är false, minimumRequiredVersion får inte anges.
mapFileExtensions Optional. Standardinställningen är false. Om truemåste alla filer i distributionen ha ett .deploy-tillägg. ClickOnce tar bort det här tillägget från dessa filer så snart det laddar ned dem från webbservern. Om du publicerar ditt program med hjälp av Visual Studio läggs tillägget automatiskt till i alla filer. Med den här parametern kan alla filer i en ClickOnce-distribution laddas ned från en webbserver som blockerar överföring av filer som slutar med "osäkra" tillägg, till exempel .exe.
disallowUrlActivation Optional. Standardinställningen är false. Om trueförhindrar du att ett installerat program startas genom att klicka på URL:en eller ange URL:en i en webbläsare. Om attributet install inte finns ignoreras det här attributet.
trustURLParameters Optional. Standardinställningen är false. Om truetillåter tillåter du att URL:en innehåller frågesträngsparametrar som skickas till programmet, ungefär som kommandoradsargument skickas till ett kommandoradsprogram. Mer information finns i How to: Retrieve Query String Information in an Online ClickOnce Application (Hämta frågesträngsinformation i ett Online ClickOnce-program).

disallowUrlActivation Om attributet är truemåste trustUrlParameters antingen undantas från manifestet eller uttryckligen anges till false.

Elementet deployment innehåller också följande underordnade element.

subscription

Optional. Innehåller elementet update . Elementet subscription har inga attribut. Om elementet subscription inte finns söker ClickOnce-programmet aldrig efter uppdateringar. install Om elementets deployment attribut är falseignoreras elementet subscription eftersom ett ClickOnce-program som startas från nätverket alltid använder den senaste versionen.

update

Required. Det här elementet är underordnat elementet subscription och innehåller antingen elementet beforeApplicationStartupexpiration eller . beforeApplicationStartup och expiration kan inte båda anges i samma distributionsmanifest.

Elementet update har inga attribut.

beforeApplicationStartup

Optional. Det här elementet är underordnat elementet update och har inga attribut. När elementet beforeApplicationStartup finns blockeras programmet när ClickOnce söker efter uppdateringar, om klienten är online. Om det här elementet inte finns söker ClickOnce först efter uppdateringar baserat på de värden som angetts för elementet expiration . beforeApplicationStartup och expiration kan inte båda anges i samma distributionsmanifest.

utgång

Optional. Det här elementet är underordnat elementet update och har inga underordnade element. beforeApplicationStartup och expiration kan inte båda anges i samma distributionsmanifest. När uppdateringskontrollen sker och en uppdaterad version identifieras cachelagrar den nya versionen medan den befintliga versionen körs. Den nya versionen installeras sedan vid nästa start av ClickOnce-programmet.

Elementet expiration stöder följande attribut.

Attribute Description
maximumAge Required. Identifierar hur gammal den aktuella uppdateringen ska bli innan programmet utför en uppdateringskontroll. Tidsenheten bestäms av attributet unit .
unit Required. Identifierar tidsenheten för maximumAge. Giltiga enheter är hours, daysoch weeks.

deploymentProvider

För .NET Framework 2.0 krävs det här elementet om distributionsmanifestet innehåller ett subscription avsnitt. För .NET Framework 3.5 och senare är det här elementet valfritt och kommer som standard att vara den server och filsökväg där distributionsmanifestet identifierades.

Det här elementet är underordnat elementet deployment och har följande attribut.

Attribute Description
codebase Required. Identifierar platsen som en URI (Uniform Resource Identifier) för distributionsmanifestet som används för att uppdatera ClickOnce-programmet. Det här elementet gör det också möjligt att vidarebefordra uppdateringsplatser för CD-baserade installationer. Måste vara en giltig URI.

Remarks

Du kan konfigurera ditt ClickOnce-program för att söka efter uppdateringar vid start, söka efter uppdateringar efter start eller aldrig söka efter uppdateringar. Om du vill söka efter uppdateringar vid start kontrollerar du att elementet beforeApplicationStartup finns under elementet update . Om du vill söka efter uppdateringar efter start kontrollerar du att elementet expiration finns under elementet update och att uppdateringsintervall tillhandahålls.

Om du vill inaktivera sökning efter uppdateringar tar du bort elementet subscription . När du anger i distributionsmanifestet att du aldrig ska söka efter uppdateringar kan du fortfarande söka efter uppdateringar manuellt med hjälp CheckForUpdate av metoden.

Note

Klassen ApplicationDeployment och API:erna System.Deployment.Application i namnområdet stöds inte i .NET Core- och .NET 5- och senare versioner. I .NET 7 stöds en ny metod för att komma åt egenskaper för programdistribution. Mer information finns i Access ClickOnce distributionsegenskaper i .NET. .NET 7 stöder inte motsvarigheten till ApplicationDeployment-metoder.

Mer information om hur distributionProvider relaterar till uppdateringar finns i Välja en ClickOnce-uppdateringsstrategi.

Examples

I följande kodexempel visas ett deployment element i ett ClickOnce-distributionsmanifest. I exemplet används ett deploymentProvider element för att ange önskad uppdateringsplats.

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

Se även

  • Uppdaterades senast