<deployment>-Element (ClickOnce-Bereitstellung)

Artikel
03/20/2023

Identifiziert die Attribute, die für die Bereitstellung von Updates und zum Verfügbarmachen für das System verwendet werden.

Syntax


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

Elemente und Attribute

Das deployment -Element ist erforderlich und befindet sich im urn:schemas-microsoft-com:asm.v2 -Namespace. Das Element weist folgende Attribute auf.

Attribut	BESCHREIBUNG
`install`	Erforderlich. Gibt an, ob diese Anwendung im Windows-Menü Start und in der Systemsteuerung-Anwendung Programm hinzufügen oder entfernen vorhanden ist. Gültige Werte sind `true` und `false`. Wenn `false` zutrifft, führt ClickOnce immer die neueste Version dieser Anwendung aus dem Netzwerk aus und erkennt das `subscription`-Element nicht.
`minimumRequiredVersion`	Optional. Gibt die Mindestversion dieser Anwendung an, die auf dem Client ausgeführt werden kann. Wenn die Versionsnummer der Anwendung kleiner ist als die im Bereitstellungsmanifest angegebene Versionsnummer, wird die Anwendung nicht ausgeführt. Versionsnummern müssen im Format `N.N.N.N` angegeben werden, wobei `N` eine ganze Zahl ohne Vorzeichen ist. Wenn das `install`-Attribut `false` ist, darf `minimumRequiredVersion` nicht festgelegt werden.
`mapFileExtensions`	Optional. Wird standardmäßig auf `false` festgelegt. Wenn `true` zutrifft, müssen alle Dateien in der Bereitstellung über die Erweiterung „.deploy“ verfügen. ClickOnce entfernt diese Erweiterung aus diesen Dateien, sobald sie vom Webserver heruntergeladen werden. Wenn Sie Ihre Anwendung mit Visual Studio veröffentlichen, wird diese Erweiterung automatisch allen Dateien hinzugefügt. Mit diesem Parameter können alle Dateien innerhalb einer ClickOnce-Bereitstellung von einem Webserver heruntergeladen werden, der die Übertragung von Dateien mit „unsicheren“ Erweiterungen wie „.exe“ blockiert.
`disallowUrlActivation`	Optional. Wird standardmäßig auf `false` festgelegt. Wenn `true` zutrifft, wird verhindert, dass eine installierte Anwendung durch Klicken auf die URL oder durch Eingabe der URL in einem Browser gestartet wird. Wenn das Attribut `install` nicht vorhanden ist, wird dieses Attribut ignoriert.
`trustURLParameters`	Optional. Wird standardmäßig auf `false` festgelegt. Wenn `true` zutrifft, kann die URL Abfragezeichenfolgenparameter enthalten, die an die Anwendung übergeben werden, ähnlich wie Befehlszeilenargumente an eine Befehlszeilenanwendung übergeben werden. Weitere Informationen finden Sie unter Abrufen von Abfragezeichenfolgeninformationen in einer ClickOnce-Onlineanwendung. Wenn das `disallowUrlActivation`-Attribut `true` ist, muss `trustUrlParameters` entweder aus dem Manifest ausgeschlossen oder explizit auf `false` festgelegt werden.

Das deployment-Element enthält auch die folgenden untergeordneten Elemente.

Abonnement

Optional. Enthält das update-Element. Das subscription -Element weist keine Attribute auf. Wenn das subscription-Element nicht vorhanden ist, sucht die ClickOnce-Anwendung nie nach Updates. Wenn das install-Attribut des deployment-Elements false ist, wird das subscription-Element ignoriert, da eine ClickOnce-Anwendung, die aus dem Netzwerk gestartet wird, immer die neueste Version verwendet.

aktualisieren

Erforderlich. Dieses Element ist ein untergeordnetes Element des subscription-Elements und enthält entweder das Element beforeApplicationStartup oder expiration. beforeApplicationStartup und expiration können nicht beide im selben Bereitstellungsmanifest angegeben werden.

Das update -Element weist keine Attribute auf.

beforeApplicationStartup

Optional. Dieses Element ist ein untergeordnetes Element des update -Elements und weist keine Attribute auf. Wenn das beforeApplicationStartup-Element vorhanden ist, wird die Anwendung blockiert, wenn ClickOnce nach Updates sucht, sofern der Client online ist. Wenn dieses Element nicht vorhanden ist, sucht ClickOnce zunächst auf der Grundlage der für das expiration-Element angegebenen Werte nach Updates. beforeApplicationStartup und expiration können nicht beide im selben Bereitstellungsmanifest angegeben werden.

expiration

Optional. Dieses Element ist ein untergeordnetes Element des update -Elements und weist keine untergeordneten Elemente auf. beforeApplicationStartup und expiration können nicht beide im selben Bereitstellungsmanifest angegeben werden. Wenn die Updateüberprüfung erfolgt und eine aktualisierte Version erkannt wird, wird die neue Version im Cache gespeichert, während die vorhandene Version ausgeführt wird. Die neue Version wird dann beim nächsten Start der ClickOnce-Anwendung installiert.

Das expiration-Element unterstützt die folgenden Attribute.

Attribut	BESCHREIBUNG
`maximumAge`	Erforderlich. Gibt an, wie alt das aktuelle Update sein sollte, bevor die Anwendung eine Updateüberprüfung durchführt. Die Zeiteinheit wird durch das `unit`-Attribut bestimmt.
`unit`	Erforderlich. Gibt die Zeiteinheit für `maximumAge` an. `hours`, `days` und `weeks` sind gültige Einheiten.

deploymentProvider

Für .NET Framework 2.0 ist dieses Element erforderlich, wenn das Bereitstellungsmanifest einen subscription-Abschnitt enthält. Für .NET Framework 3.5 und höher ist dieses Element optional und wird standardmäßig auf den Server und den Dateipfad festgelegt, in dem das Bereitstellungsmanifest gefunden wurde.

Dieses Element ist ein untergeordnetes Element des deployment -Elements und weist folgende Attribute auf.

Attribut	BESCHREIBUNG
`codebase`	Erforderlich. Gibt den Speicherort als URI (Uniform Resource Identifier) des Bereitstellungsmanifests an, das zum Aktualisieren der ClickOnce-Anwendung verwendet wird. Dieses Element ermöglicht auch das Weiterleiten von Updatespeicherorten für CD-basierte Installationen. Muss ein gültiger URI sein.

Bemerkungen

Sie können Ihre ClickOnce-Anwendung so konfigurieren, dass sie beim Start nach Updates sucht, nach dem Start nach Updates sucht oder nie nach Updates sucht. Damit beim Start nach Updates gesucht wird, stellen Sie sicher, dass das Element beforeApplicationStartup unter dem Element update vorhanden ist. Wenn nach dem Start nach Updates gesucht werden soll, stellen Sie sicher, dass das Element expiration unter dem Element update vorhanden ist und dass Updateintervalle angegeben sind.

Um die Suche nach Updates zu deaktivieren, entfernen Sie das Element subscription. Wenn Sie im Bereitstellungsmanifest angeben, dass nie nach Updates gesucht werden soll, können Sie dennoch manuell nach Updates suchen, indem Sie die Methode CheckForUpdate verwenden.

Hinweis

Die Klasse ApplicationDeployment und die APIs im Namespace System.Deployment.Application werden in .NET Core und .NET 5 und höheren Versionen nicht unterstützt. In .NET 7 wird eine neue Methode für den Zugriff auf Anwendungsbereitstellungseigenschaften unterstützt. Weitere Informationen finden Sie unter Zugreifen auf ClickOnce-Bereitstellungseigenschaften in .NET. .NET 7 unterstützt nicht das Äquivalent von ApplicationDeployment-Methoden.

Weitere Informationen darüber, wie deploymentProvider mit Updates zusammenhängt, finden Sie unter Auswählen einer Strategie für die ClickOnce-Aktualisierung.

Beispiele

Das folgende Codebeispiel zeigt ein deployment-Element in einem ClickOnce-Bereitstellungsmanifest. Im Beispiel wird ein deploymentProvider-Element verwendet, um den bevorzugten Updatespeicherort anzugeben.

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

Weitere Informationen

ClickOnce-Bereitstellungsmanifest

Freigeben über