ApplicationSettingsBase.Upgrade Yöntem

Tanım

Ad Alanı:

System.Configuration

Bütünleştirilmiş Kod:

System.Configuration.ConfigurationManager.dll

Paket:

System.Configuration.ConfigurationManager v8.0.0

Kaynak:

ApplicationSettingsBase.cs

Uygulama ayarlarını uygulamanın daha yeni bir yüklemesini yansıtacak şekilde Güncelleştirmeler.

public:
 virtual void Upgrade();

public virtual void Upgrade ();

abstract member Upgrade : unit -> unit
override this.Upgrade : unit -> unit

Public Overridable Sub Upgrade ()

Özel durumlar

ConfigurationErrorsException

Yapılandırma dosyası ayrıştırılamadı.

Açıklamalar

yöntemi, Upgrade bir uygulamanın yeni sürümüne sorunsuz geçiş sağlamak için iki eylem gerçekleştirir:

• Arabirimini uyguladıklarını IApplicationSettingsProvider varsayarak, yükseltilen uygulamanın mevcut olup olmadığını ilgili tüm ayar sağlayıcılarına yöntemine IApplicationSettingsProvider.Upgrade yapılan bir çağrı aracılığıyla bildirir. Ayarlar sarmalayıcı sınıfı ile NoSettingsVersionUpgradeAttributeişaretlenmişse bu eylem gerçekleştirilmez.

• Tüm uygulama ayarlarının değerlerini yeniden yükler.

Özel yükseltme veya birleştirme davranışını uygulamak için varsayılan davranışını Upgrade geçersiz kılabilirsiniz. GetPreviousVersion Uygulamanın önceki sürümü için bir ayarın tek tek değerlerini almak için yöntemini kullanın. Özel yükseltme davranışına örnek olarak şunlar verilebilir:

• Önceki kullanıcı tarafından belirtilen değerlerden veya önceki varsayılan değerlerden birini veya daha fazlasını geçersiz kılan yeni ilke varsayılanlarını kullanma.

• Eski değerlerin daha yeni aralıklarla, farklı ayarlar özellik grubuyla vb. uyumlu olacak şekilde özel çevirisi.

Ayrıca bkz.

• Providers
• Reload()
• GetPreviousVersion(String)
• NoSettingsVersionUpgradeAttribute
• Upgrade(SettingsContext, SettingsPropertyCollection)