Taal

<implementatie-element> (ClickOnce-implementatie)

Identificeert de kenmerken die worden gebruikt voor de implementatie van updates en blootstelling aan het systeem.

Syntaxis


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

Elementen en kenmerken

Het deployment element is vereist en bevindt zich in de urn:schemas-microsoft-com:asm.v2 naamruimte. Het element heeft de volgende kenmerken.

Attribute Description
install Required. Hiermee geeft u op of deze toepassing een aanwezigheid definieert in het menu Start van Windows en in de toepassing Configuratiescherm Programma's toevoegen of verwijderen. Geldige waarden zijn true en false. Als falseClickOnce altijd de nieuwste versie van deze toepassing vanuit het netwerk uitvoert en het subscription element niet herkent.
minimumRequiredVersion Optional. Hiermee geeft u de minimale versie van deze toepassing die op de client kan worden uitgevoerd. Als het versienummer van de toepassing kleiner is dan het versienummer dat is opgegeven in het implementatiemanifest, wordt de toepassing niet uitgevoerd. Versienummers moeten worden opgegeven in de notatie N.N.N.N, waarbij N een niet-ondertekend geheel getal is. Als het install kenmerk is false, minimumRequiredVersion mag niet worden ingesteld.
mapFileExtensions Optional. Wordt standaard ingesteld op false. Als truealle bestanden in de implementatie een .deploy-extensie moeten hebben. ClickOnce verwijdert deze extensie van deze bestanden zodra deze van de webserver wordt gedownload. Als u uw toepassing publiceert met behulp van Visual Studio, wordt deze extensie automatisch toegevoegd aan alle bestanden. Met deze parameter kunnen alle bestanden in een ClickOnce-implementatie worden gedownload vanaf een webserver die de verzending van bestanden blokkeert die eindigen op 'onveilige' extensies zoals .exe.
disallowUrlActivation Optional. Wordt standaard ingesteld op false. Als true, voorkomt u dat een geïnstalleerde toepassing wordt gestart door op de URL te klikken of de URL in te voeren in een browser. Als het install kenmerk niet aanwezig is, wordt dit kenmerk genegeerd.
trustURLParameters Optional. Wordt standaard ingesteld op false. Als truede URL queryreeksparameters bevat die in de toepassing worden doorgegeven, worden net als opdrachtregelargumenten doorgegeven aan een opdrachtregeltoepassing. Zie Procedure: Queryreeksinformatie ophalen in een Online ClickOnce-toepassing voor meer informatie.

Als het disallowUrlActivation kenmerk is true, trustUrlParameters moet worden uitgesloten van het manifest of expliciet worden ingesteld op false.

Het deployment element bevat ook de volgende onderliggende elementen.

subscription

Optional. Bevat het update element. Het subscription element heeft geen kenmerken. Als het subscription element niet bestaat, scant de ClickOnce-toepassing nooit op updates. Als het install kenmerk van het deployment element is false, wordt het subscription element genegeerd, omdat een ClickOnce-toepassing die wordt gestart vanuit het netwerk altijd de nieuwste versie gebruikt.

update

Required. Dit element is een onderliggend subscription element en bevat het beforeApplicationStartup of het expiration element. beforeApplicationStartup en expiration kan niet beide worden opgegeven in hetzelfde implementatiemanifest.

Het update element heeft geen kenmerken.

beforeApplicationStartup

Optional. Dit element is een onderliggend update element en heeft geen kenmerken. Wanneer het beforeApplicationStartup element bestaat, wordt de toepassing geblokkeerd wanneer ClickOnce controleert op updates, als de client online is. Als dit element niet bestaat, scant ClickOnce eerst op updates op basis van de waarden die voor het expiration element zijn opgegeven. beforeApplicationStartup en expiration kan niet beide worden opgegeven in hetzelfde implementatiemanifest.

expiration

Optional. Dit element is een onderliggend element en update heeft geen onderliggende elementen. beforeApplicationStartup en expiration kan niet beide worden opgegeven in hetzelfde implementatiemanifest. Wanneer de updatecontrole plaatsvindt en er een bijgewerkte versie wordt gedetecteerd, wordt de nieuwe versie in de cache opgeslagen terwijl de bestaande versie wordt uitgevoerd. De nieuwe versie wordt vervolgens geïnstalleerd bij de volgende start van de ClickOnce-toepassing.

Het expiration element ondersteunt de volgende kenmerken.

Attribute Description
maximumAge Required. Hiermee wordt aangegeven hoe oud de huidige update moet worden voordat de toepassing een updatecontrole uitvoert. De tijdseenheid wordt bepaald door het unit kenmerk.
unit Required. Identificeert de tijdseenheid voor maximumAge. Geldige eenheden zijn hours, daysen weeks.

deploymentProvider

Voor het .NET Framework 2.0 is dit element vereist als het implementatiemanifest een subscription sectie bevat. Voor het .NET Framework 3.5 en hoger is dit element optioneel en wordt dit standaard ingesteld op de server en het bestandspad waarin het implementatiemanifest is gedetecteerd.

Dit element is een onderliggend deployment element en heeft het volgende kenmerk.

Attribute Description
codebase Required. Identificeert de locatie, als een URI (Uniform Resource Identifier), van het implementatiemanifest dat wordt gebruikt om de ClickOnce-toepassing bij te werken. Met dit element kunt u ook updatelocaties doorsturen voor cd-installaties. Moet een geldige URI zijn.

Remarks

U kunt uw ClickOnce-toepassing configureren om te scannen op updates bij het opstarten, te scannen op updates na het opstarten of nooit op updates te controleren. Als u wilt scannen op updates bij het opstarten, moet u ervoor zorgen dat het beforeApplicationStartup element onder het update element bestaat. Als u wilt scannen op updates na het opstarten, moet u ervoor zorgen dat het expiration element onder het update element bestaat en dat update-intervallen worden opgegeven.

Als u de controle op updates wilt uitschakelen, verwijdert u het subscription element. Wanneer u in het implementatiemanifest opgeeft dat u nooit op updates wilt scannen, kunt u nog steeds handmatig controleren op updates met behulp van de CheckForUpdate methode.

Opmerking

De ApplicationDeployment klasse en API's in de System.Deployment.Application naamruimte worden niet ondersteund in .NET Core en .NET 5 en latere versies. In .NET 7 wordt een nieuwe methode voor het openen van toepassingsimplementatie-eigenschappen ondersteund. Zie Access ClickOnce-implementatie-eigenschappen in .NET voor meer informatie. .NET 7 biedt geen ondersteuning voor het equivalent van ApplicationDeployment-methoden.

Zie Een ClickOnce-updatestrategie kiezen voor meer informatie over hoe deploymentProvider zich verhoudt tot updates.

Examples

In het volgende codevoorbeeld ziet u een deployment element in een ClickOnce-implementatiemanifest. In het voorbeeld wordt een deploymentProvider element gebruikt om de gewenste updatelocatie aan te geven.

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

Zie ook

  • Laatst bijgewerkt om