LocalFileSettingsProvider.Upgrade Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Ö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 -> unitPublic 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
Özel durumlar
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.
