<deployment> öğesi (ClickOnce dağıtımı)

Güncelleştirmelerin dağıtımı ve sisteme açık olması için kullanılan öznitelikleri tanımlar.

Sözdizimi

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

Öğeler ve öznitelikler

deployment öğesi gereklidir ve ad alanındadırurn:schemas-microsoft-com:asm.v2. öğesi aşağıdaki özniteliklere sahiptir.

Öznitelik	Açıklama
install	Gerekli. Bu uygulamanın Windows Başlat menüsünde ve Denetim Masası Program Ekle veya Kaldır uygulamasında bir iletişim durumu tanımlayıp tanımlamadığını belirtir. Geçerli değerler: true ve false. ise false, ClickOnce her zaman ağdan bu uygulamanın en son sürümünü çalıştırır ve öğesini tanımaz subscription .
minimumRequiredVersion	isteğe bağlı. Bu uygulamanın istemcide çalışabilecek en düşük sürümünü belirtir. Uygulamanın sürüm numarası dağıtım bildiriminde sağlanan sürüm numarasından küçükse, uygulama çalışmaz. Sürüm numaraları biçiminde N.N.N.Nbelirtilmelidir; burada N işaretsiz bir tamsayıdır. install özniteliği ise falseminimumRequiredVersion ayarlanmamalıdır.
mapFileExtensions	isteğe bağlı. varsayılan değeridir false. ise true, dağıtımdaki tüm dosyaların bir .deploy uzantısı olmalıdır. ClickOnce, bu uzantıyı Web sunucusundan indirir indirmez bu dosyaları kaldırır. Uygulamanızı Visual Studio kullanarak yayımlarsanız, bu uzantı otomatik olarak tüm dosyalara eklenir. Bu parametre, ClickOnce dağıtımındaki tüm dosyaların .exe gibi "güvenli olmayan" uzantılarla biten dosyaların iletimini engelleyen bir Web sunucusundan indirilmesini sağlar.
disallowUrlActivation	isteğe bağlı. varsayılan değeridir false. ise true, URL'ye tıklayarak veya URL'yi bir tarayıcıya girerek yüklü bir uygulamanın başlatılmasını engeller. install Öznitelik yoksayılır.
trustURLParameters	isteğe bağlı. varsayılan değeridir false. ise true, URL'nin uygulamaya geçirilen sorgu dizesi parametrelerini içermesine izin verir; komut satırı bağımsız değişkenleri bir komut satırı uygulamasına geçirilir. Daha fazla bilgi için bkz . Nasıl yapılır: Çevrimiçi ClickOnce Uygulamasında Sorgu Dizesi Bilgilerini Alma. disallowUrlActivation özniteliği ise truetrustUrlParameters bildirimin dışında tutulmalı veya açıkça olarak olarak falseayarlanmalıdır.

deployment öğesi aşağıdaki alt öğeleri de içerir.

aboneliği

isteğe bağlı. update öğesini içerir. öğesinin subscription özniteliği yok. subscription öğesi yoksa, ClickOnce uygulaması hiçbir zaman güncelleştirmeleri taramaz. öğesinin installdeployment özniteliği ise false, subscription ağdan başlatılan bir ClickOnce uygulaması her zaman en son sürümü kullandığından öğe yoksayılır.

update

Gerekli. Bu öğe öğenin alt öğesidir subscription ve veya expiration öğesini içerirbeforeApplicationStartup. beforeApplicationStartup ve expiration her ikisi de aynı dağıtım bildiriminde belirtilemez.

öğesinin update özniteliği yok.

beforeApplicationStartup

isteğe bağlı. Bu öğe öğesinin update alt öğesidir ve öznitelikleri yoktur. beforeApplicationStartup öğesi mevcut olduğunda, clickOnce istemci çevrimiçiyse güncelleştirmeleri denetlediğinde uygulama engellenir. Bu öğe yoksa, ClickOnce önce öğe için belirtilen değerlere göre güncelleştirmeleri tarar expiration . beforeApplicationStartup ve expiration her ikisi de aynı dağıtım bildiriminde belirtilemez.

süre sonu

isteğe bağlı. Bu öğe öğenin alt öğesidir update ve alt öğesi yoktur. beforeApplicationStartup ve expiration her ikisi de aynı dağıtım bildiriminde belirtilemez. Güncelleştirme denetimi gerçekleştiğinde ve güncelleştirilmiş bir sürüm algılandığında, mevcut sürüm çalışırken yeni sürüm önbelleğe alınır. Ardından yeni sürüm, ClickOnce uygulamasının bir sonraki başlatması üzerine yüklenir.

expiration öğesi aşağıdaki öznitelikleri destekler.

Öznitelik	Açıklama
maximumAge	Gerekli. Uygulama bir güncelleştirme denetimi gerçekleştirmeden önce geçerli güncelleştirmenin kaç yaşında olması gerektiğini tanımlar. Zaman birimi özniteliği tarafından unit belirlenir.
unit	Gerekli. için maximumAgezaman birimini tanımlar. Geçerli birimler : hours, daysve weeks.

Deploymentprovider

.NET Framework 2.0 için, dağıtım bildirimi bir subscription bölüm içeriyorsa bu öğe gereklidir. .NET Framework 3.5 ve üzeri için bu öğe isteğe bağlıdır ve dağıtım bildiriminin bulunduğu sunucu ve dosya yolunu varsayılan olarak kullanır.

Bu öğe öğesinin deployment alt öğesidir ve aşağıdaki özniteliğine sahiptir.

Öznitelik	Açıklama
codebase	Gerekli. ClickOnce uygulamasını güncelleştirmek için kullanılan dağıtım bildiriminin konumunu Tekdüzen Kaynak Tanımlayıcısı (URI) olarak tanımlar. Bu öğe, CD tabanlı yüklemeler için güncelleştirme konumlarının iletilmesine de olanak tanır. Geçerli bir URI olmalıdır.

Açıklamalar

ClickOnce uygulamanızı başlangıçta güncelleştirmeleri taramak, başlangıçtan sonra güncelleştirmeleri taramak veya hiçbir zaman güncelleştirmeleri denetlemek için yapılandırabilirsiniz. Başlangıçta güncelleştirmeleri taramak için öğesinin öğesinin beforeApplicationStartup altında bulunduğundan update emin olun. Başlatmadan sonra güncelleştirmeleri taramak için öğesinin öğesinin expiration altında bulunduğundan update ve güncelleştirme aralıklarının sağlandığından emin olun.

Güncelleştirme denetimini devre dışı bırakmak için öğesini kaldırın subscription . Dağıtım bildiriminde güncelleştirmeleri hiçbir zaman taramamak için belirttiğinizde, yöntemini kullanarak güncelleştirmeleri el ile denetlemeye CheckForUpdate devam edebilirsiniz.

Not

ApplicationDeployment Ad alanı içindeki System.Deployment.Application sınıf ve API'ler .NET Core ve .NET 5 ve sonraki sürümlerde desteklenmez. .NET 7'de, uygulama dağıtım özelliklerine erişmek için yeni bir yöntem desteklenir. Daha fazla bilgi için bkz . .NET'te ClickOnce dağıtım özelliklerine erişme. .NET 7, ApplicationDeployment yöntemlerinin eşdeğerini desteklemez.

deploymentProvider'ın güncelleştirmelerle ilişkisi hakkında daha fazla bilgi için bkz . ClickOnce Güncelleştirme Stratejisi Seçme.

Örnekler

Aşağıdaki kod örneği, ClickOnce dağıtım bildirimindeki bir deployment öğeyi gösterir. Örnek, tercih edilen güncelleştirme konumunu belirtmek için bir deploymentProvider öğe kullanır.

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

Ayrıca bkz.

• ClickOnce dağıtım bildirimi