LocalFileSettingsProvider.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:

LocalFileSettingsProvider.cs

Önceki kullanıcı kapsamlı ayarları aynı uygulamanın önceki bir sürümünden geçirmeyi dener.

public:
 virtual void Upgrade(System::Configuration::SettingsContext ^ context, System::Configuration::SettingsPropertyCollection ^ properties);

public void Upgrade (System.Configuration.SettingsContext context, System.Configuration.SettingsPropertyCollection properties);

abstract member Upgrade : System.Configuration.SettingsContext * System.Configuration.SettingsPropertyCollection -> unit
override this.Upgrade : System.Configuration.SettingsContext * System.Configuration.SettingsPropertyCollection -> unit

Public Sub Upgrade (context As SettingsContext, properties As SettingsPropertyCollection)

Parametreler

context

SettingsContext

SettingsContext Geçerli uygulama kullanımını açıklayan.

properties

SettingsPropertyCollection

SettingsPropertyCollection Değerleri alınacak ayarlar özellik grubunu içeren.

Uygulamalar

Upgrade(SettingsContext, SettingsPropertyCollection)

Özel durumlar

ConfigurationErrorsException

Kullanıcı kapsamlı bir ayarla karşılaşıldı, ancak geçerli yapılandırma yalnızca uygulama kapsamlı ayarları destekliyor.

-veya-

Yapılandırma dosyasının önceki sürümüne erişilemedi.

Açıklamalar

LocalFileSettingsProvider yerel ve dolaşım ayarlarını ayrı işlemlerde geçirir.

Upgrade yöntemi, uygulanan her uygulama ayarı NoSettingsVersionUpgradeAttribute için veya öğesinden ApplicationSettingsBasetüretilen tüm ayarlar sarmalayıcı sınıfı için gösterilmez.

Bu yöntem bu şekilde çağrılır, yükseltilmekte olan uygulamanın türüne bağlıdır:

• ClickOnce uygulamasının her sürümü kendi yalıtılmış yükleme dizininde depolanır. ClickOnce uygulamasının yeni bir sürümü yüklendikten sonra ve yeni sürüm ilk kez çalıştırıldığında, iç mantık tüm ortak uygulama ayarlarını yeni sürüme geçirmek için otomatik olarak çağrısı Upgrade yapacaktır. Daha fazla bilgi için bkz. ClickOnce ve Uygulama Ayarları.

• Standart Windows Forms ve konsol uygulamalarının uygulamasını el ile çağırması Upgradegerekir çünkü bu tür bir uygulamanın ilk çalıştırılma zamanlarını belirlemenin genel, otomatik bir yolu yoktur. Bunu yapmanın iki yaygın yolu, yükleme programından veya uygulamanın kendisinden, kalıcı bir özellik kullanarak (genellikle gibi IsFirstRunbir adla adlandırılır) kullanmaktır.

Yeni sürümün uygulama ayarlarını geçirmesi için uygulama ayarlarının eski sürümünü de yükleyebilmesi ve okuyabilmesi gerektiğini unutmayın. Bu nedenle, uygulamanın hem yeni hem de önceki sürümleriyle uyumlu sarmalayıcı sınıfları içermelidir.

Ayrıca bkz.

• GetPreviousVersion(SettingsContext, SettingsProperty)
• Reset(SettingsContext)
• IApplicationSettingsProvider
• NoSettingsVersionUpgradeAttribute