Sprache

<Deployment-Element (ClickOnce-Bereitstellung> )

Identifiziert die Attribute, die für die Bereitstellung von Updates und die Gefährdung des Systems 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 die folgenden Attribute auf.

Attribute Description
install Required. Gibt an, ob diese Anwendung eine Anwesenheit im Windows Startmenü und in der Anwendung Systemsteuerung "Programme hinzufügen" oder "Programme entfernen" definiert. Gültige Werte sind true und false. Wenn false, ClickOnce immer die neueste Version dieser Anwendung aus dem Netzwerk ausführt und das subscription Element nicht erkennt.
minimumRequiredVersion Dies ist optional. Gibt die Mindestversion dieser Anwendung an, die auf dem Client ausgeführt werden kann. Wenn die Versionsnummer der Anwendung kleiner als die im Bereitstellungsmanifest angegebene Versionsnummer ist, wird die Anwendung nicht ausgeführt. Versionsnummern müssen im Format N.N.N.Nangegeben werden, wobei N es sich um eine nicht signierte ganze Zahl handelt. Wenn das install Attribut lautet false, minimumRequiredVersion darf nicht festgelegt werden.
mapFileExtensions Dies ist optional. Wird standardmäßig auf false festgelegt. Wenn true, müssen alle Dateien in der Bereitstellung über eine Bereitstellungserweiterung verfügen. ClickOnce entfernt diese Erweiterung aus diesen Dateien, sobald sie vom Webserver heruntergeladen werden. Wenn Sie Ihre Anwendung mithilfe von Visual Studio veröffentlichen, wird diese Erweiterung automatisch allen Dateien hinzugefügt. Mit diesem Parameter können alle Dateien in einer ClickOnce-Bereitstellung von einem Webserver heruntergeladen werden, der die Übertragung von Dateien blockiert, die mit "unsicheren" Erweiterungen wie .exeenden.
disallowUrlActivation Dies ist optional. Wird standardmäßig auf false festgelegt. Wenn true, verhindert, dass eine installierte Anwendung gestartet wird, indem Sie auf die URL klicken oder die URL in einen Browser eingeben. Wenn das install Attribut nicht vorhanden ist, wird dieses Attribut ignoriert.
trustURLParameters Dies ist optional. Wird standardmäßig auf false festgelegt. Wenn truedie URL abfragezeichenfolgenparameter enthalten kann, die an die Anwendung übergeben werden, werden ähnlich wie Befehlszeilenargumente an eine Befehlszeilenanwendung übergeben. Weitere Informationen finden Sie unter How to: Retrieve Query String Information in an Online ClickOnce Application.

Wenn das disallowUrlActivation Attribut lautet true, trustUrlParameters muss entweder vom Manifest ausgeschlossen oder explizit auf false.

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

Abonnement

Dies ist optional. Enthält das update Element. Das subscription Element hat keine Attribute. Wenn das subscription Element nicht vorhanden ist, sucht die ClickOnce-Anwendung nie nach Updates. Wenn das install Attribut des deployment Elements lautet false, wird das subscription Element ignoriert, da eine ClickOnce-Anwendung, die über das Netzwerk gestartet wird, immer die neueste Version verwendet.

Aktualisierung

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

Das update Element hat keine Attribute.

beforeApplicationStartup

Dies ist optional. Dieses Element ist ein untergeordnetes Element des update Elements und hat keine Attribute. Wenn das beforeApplicationStartup Element vorhanden ist, wird die Anwendung blockiert, wenn ClickOnce nach Updates sucht, wenn der Client online ist. Wenn dieses Element nicht vorhanden ist, sucht ClickOnce zuerst auf Aktualisierungen basierend auf den für das expiration Element angegebenen Werten. beforeApplicationStartup und expiration nicht beide im gleichen Bereitstellungsmanifest angegeben werden können.

expiration

Dies ist optional. Dieses Element ist ein untergeordnetes Element des update Elements und hat keine untergeordneten Elemente. beforeApplicationStartup und expiration nicht beide im gleichen Bereitstellungsmanifest angegeben werden können. Wenn die Updateüberprüfung auftritt und eine aktualisierte Version erkannt wird, werden die neuen Versionen zwischengespeichert, 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.

Attribute Description
maximumAge Required. Gibt an, wie alt das aktuelle Update werden soll, bevor die Anwendung eine Aktualisierungsprüfung durchführt. Die Zeiteinheit wird durch das unit Attribut bestimmt.
unit Required. Identifiziert die Zeiteinheit für maximumAge. Gültige Einheiten sind hours, daysund weeks.

deploymentProvider

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

Dieses Element ist ein untergeordnetes Element des deployment Elements und hat das folgende Attribut.

Attribute Description
codebase Required. 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.

Hinweise

Sie können Ihre ClickOnce-Anwendung so konfigurieren, dass sie nach Updates beim Start sucht, nach Updates nach dem Start sucht oder nie nach Updates sucht. Um nach Updates beim Start zu suchen, stellen Sie sicher, dass das beforeApplicationStartup Element unter dem update Element vorhanden ist. Um nach Updates nach dem Start zu suchen, stellen Sie sicher, dass das expiration Element unter dem update Element vorhanden ist und dass Aktualisierungsintervalle bereitgestellt werden.

Um die Überprüfung auf Updates zu deaktivieren, entfernen Sie das subscription Element. Wenn Sie im Bereitstellungsmanifest angeben, dass sie niemals nach Updates suchen sollen, können Sie mithilfe der CheckForUpdate Methode weiterhin manuell nach Updates suchen.

Note

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

Weitere Informationen dazu, wie deploymentProvider sich auf Updates bezieht, finden Sie unter Auswählen einer ClickOnce-Updatestrategie.

Examples

Das folgende Codebeispiel veranschaulicht ein deployment Element in einem ClickOnce-Bereitstellungsmanifest. Im Beispiel wird ein deploymentProvider Element verwendet, um den bevorzugten Aktualisierungsspeicherort 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>

Siehe auch

  • Last updated on