Aracılığıyla paylaş


Uygulama ayarlarını yönetme

Uygulama ayarlarını depolamak ve özellik ayarları ve diğer bilgileri uygulamanız için dinamik olarak almak etkinleştirin. Bunlar da özel uygulama ve kullanıcı tercihleri istemci bilgisayarda etkinleştirin. Genellikle uygulama çalışan için önemli ve doğrudan uygulama kodunun dahil etmek istemediğiniz verileri (örneğin, bir bağlantı dizesi) olur. İki farklı veritabanı bağlantı dizeleri depolamak ve bunlardan birini bilgisayarın konumuna bağlı çalışma zamanında almak isteyebilirsiniz. Ya da bir kullanıcının renk tercihlerini depolamak ve bunları uygulama başlatıldığında almak isteyebilirsiniz.

Uygulama ayarları olduğunu unutmayın bir Visual Studio önceki sürümlerde dinamik özellikler özelliğini değiştirir özelliği.

Her uygulama ayarı benzersiz bir adı olmalıdır. Ad harf, sayı ya da sayı ile başlamıyor bir altçizgi herhangi bir birleşimi olabilir ve boşluk içeremez. Ad yoluyla değiştirilebilir Name özelliği.

Uygulama ayarları XML seri hale getirilebilir veya herhangi bir veri türü olarak depolanabilir bir TypeConverter , uygulayan ToString/FromString. En yaygın türleri String, Integer, ve Boolean, ancak değerler olarak da saklayabilirsiniz Color, Object, veya bağlantı dizesi.

Uygulama ayarları, ayrıca bir değer içerir. Değer olarak değeri özelliği ve ayarı veri türüyle eşleşmesi gerekir.

Buna ek olarak, uygulama ayarlarını bir form veya denetim özelliği için tasarım zamanında bağlanabilir.

İki tür kapsam tabanlı uygulama ayarları şunlardır:

  • Ayarları uygulama kapsamlı bir Web hizmeti veya veritabanı bağlantı dizesi için bir url gibi bilgiler için kullanılabilir. Bu uygulama ile ilişkili değerlerdir. Bu nedenle, kullanıcılar bunları zamanında değiştiremezsiniz.

  • Ayarları kullanıcı kapsamlı bilgi formu veya yazı tipi tercih son konumunu kalıcı yapma gibi kullanılabilir. Kullanıcılar, çalışma zamanında bu değerleri değiştirebilir.

Bir ayar kullanarak değiştirmek Kapsam özelliği.

Proje sistemi uygulama ayarları iki xml dosyalarında saklar: ilk uygulama ayarı; oluşturduğunuzda, tasarım zamanında oluşturulan bir app.config dosyası ve uygulamayı çalıştırdığında kullanıcı herhangi bir kullanıcı ayarı değeri değiştiğinde çalışma zamanında oluşturulan bir user.config dosyası. Kullanıcı ayarlarındaki değişiklikleri uygulama özellikle Bunu yapmak için bir yöntemi çağırır sürece diske yazılmaz dikkat edin.

Tasarım zamanında uygulama ayarları oluşturma

Tasarım zamanında uygulama ayarları iki şekilde oluşturabilirsiniz: kullanarak ayarları sayfası Proje Tasarımcısı, veya kullanarak özelliklerini bir form veya bir özellik ayarı bağlanmasını sağlayan denetim penceresi.

Uygulama kapsamlı bir ayarı (örneğin, bir veritabanı bağlantı dizesi veya sunucu kaynaklarını başvuru), oluşturduğunuzda, Visual Studio ile app.config kaydeder <applicationSettings> etiket. (Bağlantı dizeleri altında kaydedilen <connectionStrings> etiket.)

Kullanıcı kapsamı ayarı (örneğin, varsayılan yazı tipi, giriş sayfası veya pencere boyutu), oluşturduğunuzda, Visual Studio ile app.config kaydeder <userSettings> etiket.

Güvenlik NotuGüvenlik Notu

Bağlantı dizeleri app.config depoladığınız zaman, parolaları veya bağlantı dizesi sunucu yolları gibi hassas bilgileri açıklayacak önlemek için önlem almalısınız.

Bağlantı dizesi bilgilerinin kullanıcı kimliği ve parola sağlayarak kullanıcı gibi harici bir kaynaktan yararlanmak, bağlantınızın davranışını değiştirmek ek bağlantı dizesi parametreleri, bağlantı dizesi oluşturmak için kullandığınız değerleri içermeyen sağlamak dikkatli olmanız gerekir.

Yapılandırma dosyasında önemli bilgileri şifrelemek için korumalı yapılandırma özelliğini kullanmayı düşünün.Daha fazla bilgi için bkz. Securing Connection Strings.

Not

Sınıf kitaplıkları için hiçbir yapılandırma dosyası model olduğundan sınıf kitaplığı projelerinde uygulama ayarları uygulanmaz.Bir Visual Studio Araçları yapılandırma dosyası olan Office dll proje istisnadır.

Özelleştirilmiş ayar dosyalarını kullanma

Projeniz için uygun yönetim gruplarını ayarların özelleştirilmiş ayarlar dosyaları ekleyebilirsiniz. Tek bir dosyada bulunan ayarları yüklenir ve bir birim olarak kaydedilir. Bu nedenle, ayarları için ayrı dosyalarda saklamak için sık kullanılan ve kullanılmayan gruplarının ayarlarını kaydetme ve yükleme zamandan kazanabilirsiniz.

Örneğin, bir dosya SpecialSettings.settings gibi projenize ekleyebilirsiniz. Sırada, SpecialSettings sınıf sergilenen değil My ad View Code içeren özel ayarlar dosyasını okuyabilen Partial Class SpecialSettings.

Ayarlar Tasarımcısı ilk proje sistemin oluşturduğu için Settings.settings dosyasını arar; Bu proje Tasarımcısı görüntüler varsayılan dosya, ayarları sekmesi. Settings.Settings My proje klasöründe bulunan Visual Basic projeleri ve Properties klasörünü Visual C# projeleri. Proje Tasarımcısı sonra projenin kök klasördeki diğer ayarları dosyaları arar. Bu nedenle, özel ayarları dosyanız varsa koymanız gerekir. Projenizde başka bir yerde .settings dosyası eklerseniz, proje Tasarımcısı bulmak mümkün olmayacak.

Erişme veya Visual Basic çalışma zamanında uygulama ayarlarını değiştirme

De Visual Basic projeleri, çalıştırma sırasında uygulama ayarları kullanarak erişebilirsiniz My.Settings nesnesi. Üzerinde ayarları ı sayfa Görünüm kodu Settings.vb dosyasını görüntülemek için düğmeyi. Tanımlar Settings.vb Settings bu ayarları sınıfı olayları işlemek sağlayan bir sınıf: SettingChanging, PropertyChanged, SettingsLoaded, ve SettingsSaving. Dikkat Settings Settings.vb sınıfında ise yalnızca kullanıcıya ait kod, oluşturulan tüm sınıf görüntüler kısmi bir sınıf. Uygulama ayarlarını kullanarak erişme hakkında daha fazla bilgi için My.Settings nesne için bkz: Uygulama ayarları (Visual Basic) erişme.

Değerleri (örneğin, formun konumunu) zamanında kullanıcı değişiklikleri kapsamlı kullanıcı ayarlarını user.config dosyasında saklanır. Varsayılan değer app.config kaydedilir ve dikkat edin.

Örnek uygulama, çalışma sırasında herhangi bir kullanıcı kapsamlı ayarlarını değiştirmiş ve isterseniz bu ayarları varsayılan değerlerine sıfırlamak tıklatın Eşitle düğme.

Kullanmanızı öneririz My.Settings nesnesi ve varsayılan .settings dosyasına erişim ayarları. Bu özellikler atamak ayarlar Tasarımcısı kullanın ve ayrıca, önce uygulamayı kapatma kullanıcı ayarlarını otomatik olarak kaydedilir, çünkü. Ancak, sizin Visual Basic uygulama erişim ayarları doğrudan. Bu durumda, gerek erişim MySettings sınıf ve proje kök özel .settings dosyasını kullanın. Bir C# uygulama yaptığınız gibi kullanıcı ayarlarını uygulama sonlandırmadan önce de kaydetmelisiniz; Bu durum aşağıdaki bölümde açıklanmaktadır.

Erişme veya Visual C# [NULL]'ta çalışma zamanında uygulama ayarlarını değiştirme

Farklı dillerde Visual Basic, gibi Visual C#, erişmesi gereken Settings , aşağıda gösterildiği gibi doğrudan sınıf Visual C# örnek.

Properties.Settings.Default.FirstUserSetting = "abc";

Ayrıca açıkça çağırmalıdır Save kullanıcı ayarları kalıcı olmasını bu sarmalayıcı sınıf yöntemi. Genellikle bunu Closing ana formun olay işleyicisi. Aşağıdaki Visual C# örnek gösterir çağrısı Save yöntemi.

Properties.Settings.Default.Save();

Yeni uygulama ayarları oluşturmak ve form özelliklerini bağlamanıza nasıl belirli bir örnek için bkz: Nasıl yapılır: Designer'ı kullanarak uygulama ayarları oluştur. Uygulama Ayarları aracılığıyla erişme hakkında daha fazla genel bilgi için Settings sınıfı için bkz: Uygulama ayarlarına genel bakış.

Ayrıca bkz.

Kavramlar

Uygulama ayarları (Visual Basic) erişme