ClickOnce ve Uygulama Ayarları
Windows Form'a yönelik uygulama ayarları istemci üzerinde özel uygulama ve kullanıcı tercihlerini oluşturmayı, depolamayı ve sürdürmeyi kolaylaştırır. Aşağıdaki belge bir ClickOnce uygulamasında uygulama ayarları dosyalarının nasıl çalıştığını ve kullanıcı uygulamayı sonraki sürüme yükselttiğinde ClickOnce'ın ayarları nasıl geçirdiğini açıklar.
Aşağıdaki bilgiler yalnızca varsayılan uygulama ayarları sağlayıcısı LocalFileSettingsProvider sınıfına uygulanabilir. Özel bir sağlayıcı temin ederseniz, bu sağlayıcı verinin nasıl depolanacağını ve ayarlarının sürümler arasında nasıl yükseltileceğini belirleyecektir. Uygulama ayarları sağlayıcıları üzerine daha fazla bilgi için, bkz. Uygulama Ayarlar mimarisi.
Uygulama Ayarları Dosyası
Uygulama ayarları iki dosya kullanır: app.exe.config ve user.config. app Windows Forms uygulamanızın adıdır. User.config uygulamanız kullanıcı kapsamı ayarlarını ilk kez depoladığında istemci üzerinde oluşturulur. Ayarlar için varsayılan değerleri tanımlarsanız, farklı olarak app.exe.config dağıtımdan önce oluşacaktır. Visual Studio, Yayımla komutunu kullandığınızda bu dosyayı otomatik olarak ekleyecektir. ClickOnce uygulamanızı Mage.exe veya MageUI.exe kullanarak oluşturursanız, uygulama bildiriminizi doldururken bu dosyanın diğer uygulama dosyalarıyla birlikte dahil edildiğinden emin olun.
ClickOnce kullanmadan dağıtılan bir Windows Forms uygulamasında, user.config dosyası kullanıcının Documents and Settings klasöründe depolanırken uygulamanın app.exe.config dosyası uygulama dizininde bulunur. Bir ClickOnce uygulamasında, app.exe.config ClickOnce uygulaması önbelleğinin içinde yer alan uygulama dizininde, user.config ise uygulamaya ait ClickOnce veri dizini içinde bulunur.
Uygulamanızın nasıl dağıtıldığına bakılmaksızın, uygulama ayarları app.exe.config için güvenli okuma yetkisi ve user.config için güvenli okuma-yazma yetkisi sağlar.
ClickOnce uygulamasında uygulama ayarları tarafından kullanılan yapılandırma dosyalarının boyutu ClickOnce önbellek boyutu ile sınırlıdır. Daha fazla bilgi için bkz. ClickOnce Önbelleğine Genel Bir Bakış.
Sürüm Yükseltme
Her ClilckOnce uygulaması sürümü diğer tüm sürümlerden ayrıldığı için, ClickOnce uygulamasına ait uygulama ayarları da diğer sürümlerin ayarlarından ayrılır. Kullanıcınız uygulamasını, uygulamanıza ait bir sonraki sürüme yükseltirse, uygulama ayarları en son (en yüksek numaralı) sürümün ayarları ile güncelleştirilmiş sürümle birlikte sağlanan ayarları karşılaştırır ve bunları yeni ayar dosyaları içinde birleştirir.
Aşağıdaki tablo, uygulamanın hangi ayarı kopyalayacağına nasıl karar verdiğini açıklar.
Değişim Türü |
Eylem Yükseltme |
|---|---|
app.exe.config'e eklenen ayar |
Yeni ayar güncel sürüme ait app.exe.config dosyası içinde birleştirilir. |
app.exe.config'den kaldırılan ayar |
Eski ayar güncel sürüme ait app.exe.config'den kaldırılır. |
Ayarın varsayılanı değişti; yerel ayar yine user.config içinde orijinal varsayılan olarak ayarlandı. |
Ayar yeni varsayılan değer ile güncel sürümün user.config'inin içinde birleştirilir. |
Ayarın varsayılanı değişti; ayar user.config içinde varsayılan olmayana ayarlandı. |
Ayar korunan ve varsayılan olmayan değer ile güncel sürümün user.config'i içinde birleştirilir. |
Kendi uygulama ayarları sarmalayıcı sınıfınızı oluşturduysanız ve güncelleştirme mantığını özelleştirmek istiyorsanız, Upgrade yöntemini geçersiz kılabilirsiniz.
ClickOnce ve Dolaşım Ayarları
ClickOnce, ayarlar dosyasının bir ağ üzerindeki makinalar arasında sizi takip etmesini sağlayan dolaşım ayarları ile çalışmaz. Dolaşım ayarlarına ihtiyacınız varsa, ya ağ üzerinde ayarları depolayan bir uygulama ayarları sağlayıcısı ya da ayarları uzak bir bilgisayarda depolama için kendi özel ayar sınıflarınızı geliştirmeniz gerekir. Ayar sağlayıcıları hakkında daha fazla bilgi için, bkz. Uygulama Ayarlar mimarisi.
Ayrıca bkz.
Kavramlar
ClickOnce Güvenliği ve Dağıtımı
Uygulama ayarlarına genel bakış