Aracılığıyla paylaş

Uygulama ayarlarını yönetme (.NET)

Uygulama ayarları, uygulama bilgilerini dinamik olarak depolamanızı sağlar. Uygulama ayarlarıyla, çalışma zamanında uygulama koduna dahil edilmemesi gereken bilgileri depolamak için bir istemci bilgisayar kullanabilirsiniz. Uygulama ayarları bağlantı dizelerini, kullanıcı tercihlerini ve daha fazlasını içerebilir.

Not

Uygulama ayarları, Visual Studio'nun önceki sürümlerinde kullanılan dinamik özelliklerin yerini alır.

Her uygulama ayarının benzersiz bir adı olmalıdır. Ad herhangi bir harf, sayı veya alt çizgi birleşimi olabilir. Ad bir sayı ile başlayamaz ve boşluk olamaz. Ad, Name özelliği aracılığıyla değiştirilir.

Uygulama ayarları, XML olarak serileştirilen herhangi bir veri türü ya da ToString/FromStringuygulayan bir TypeConverter olarak depolanabilir. En yaygın türler String, Integerve Boolean'dır. Değerleri Color, Objectveya bağlantı dizesi olarak da depolayabilirsiniz.

Uygulama ayarları da bir değer tutar. Değer Value özelliğiyle ayarlanır ve ayarın veri türüyle eşleşmelidir.

Ayrıca, uygulama ayarları tasarım zamanında bir formun veya denetimin özelliğine bağlanabilir.

Kapsama göre iki tür uygulama ayarı vardır:

  • Uygulama kapsamlı ayarlar web hizmetinin URL'si veya veritabanı bağlantı dizesi gibi bilgiler için kullanılabilir. Bu değerler uygulamayla ilişkilendirilir. Bu nedenle, kullanıcılar çalışma zamanında bunları değiştiremez.

  • Kullanıcı kapsamlı ayarlar, bir formun son konumunu kaydetme veya yazı tipi tercihi gibi bilgiler için kullanılabilir. Kullanıcılar çalışma zamanında bu değerleri değiştirebilir.

Kapsam özelliğini kullanarak ayarın türünü değiştirebilirsiniz.

Proje sistemi, uygulama ayarlarını iki XML dosyasında depolar:

  • İlk uygulama ayarını oluşturduğunuzda tasarım zamanında oluşturulan bir app.config dosyası

  • Uygulamayı çalıştıran kullanıcı herhangi bir kullanıcı ayarının değerini değiştirdiğinde çalışma zamanında oluşturulan user.config dosyası

Uygulama bunu yapmak için özel olarak bir yöntem çağırmadığı sürece kullanıcı ayarlarındaki değişiklikler diske yazılamaz.

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

Tasarım zamanında, uygulama ayarlarını iki şekilde oluşturabilirsiniz:

  • Ayarları sayfasını Proje Tasarımcısıiçinde kullanın.

  • Bir ayarı bir özelliğe bağlamanıza olanak tanıyan form veya denetim için Özellikler penceresini kullanın.

Uygulama kapsamlı bir ayar (örneğin, bir veritabanı bağlantı dizesi veya sunucu kaynaklarına başvuru) oluşturduğunuzda, Visual Studio bunu <applicationSettings> etiketiyle app.config dosyasına kaydeder. Bağlantı dizeleri <connectionStrings> etiketi altına kaydedilir.

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

Önemli

bağlantı dizelerini app.configiçinde depoladığınızda, bağlantı dizesinde parolalar veya sunucu yolları gibi hassas bilgilerin ortaya çıkarılmasını önlemek için önlemler almanız gerekir.

Kullanıcı kimliğini ve parolasını sağlayan bir kullanıcı gibi bir dış kaynaktan bağlantı dizesi bilgilerini alırsanız, bağlantı dizenizi oluşturmak için kullandığınız değerlerin bağlantınızın davranışını değiştiren ek bağlantı dizesi parametreleri içermediğinden emin olun.

Yapılandırma dosyasındaki hassas bilgileri şifrelemek için Korumalı Yapılandırma özelliğini kullanmayı göz önünde bulundurun. Daha fazla bilgi için bkz. Bağlantı bilgilerini koruma.

Not

Sınıf kitaplıkları için yapılandırma dosyası modeli olmadığından, uygulama ayarları Sınıf Kitaplığı projeleri için geçerli değildir. Özel durum, bir yapılandırma dosyasına sahip olabilecek office çalışma zamanı DLL için Visual Studio Araçları bir projedir.

Özelleştirilmiş ayarlar dosyalarını kullanma

Ayar gruplarının kolay yönetilmesi için projenize özelleştirilmiş ayarlar dosyaları ekleyebilirsiniz. Tek bir dosyada yer alan ayarlar yüklenir ve birim olarak kaydedilir. Sık kullanılan ve seyrek kullanılan gruplar için ayarları ayrı dosyalarda depolamak, ayarların yüklenmesinde ve kaydedilmesinde zaman kazandırabilir.

Örneğin, projenize SpecialSettings.settings dosyası ekleyebilirsiniz. SpecialSettings sınıfınız My ad alanında gösterilmese de Kodu GörüntülePartial Class SpecialSettingsiçeren özel ayarlar dosyasını okuyabilir.

Ayarlar Tasarımcısı önce proje sisteminin oluşturduğu Settings.settings dosyasını arar. Bu Settings.settings dosyası, Proje TasarımcısıAyarlar sekmesinde görüntülenen varsayılan dosyadır. Settings.settings dosyası, Visual Basic projeleri için Projem klasöründe ve Visual C# projeleri için Özellikler klasöründe bulunur. Proje Tasarımcısı projenin kök klasöründeki diğer ayarlar dosyalarını arar. Bu nedenle, özel ayarlar dosyanızı oraya yerleştirmelisiniz. Projenizin başka bir yerine .settings dosyası eklerseniz, Proje Tasarımcısı dosyayı bulamaz.

Visual Basic'te çalışma zamanında uygulama ayarlarına erişme veya ayarları değiştirme

Visual Basic projelerinde, My.Settings nesnesini kullanarak çalışma zamanında uygulama ayarlarına erişebilirsiniz. Ayarlar sayfasında, Settings.vb dosyasını görüntülemek için Kodu görüntüle düğmesini seçin. Settings.vb, ayarlar sınıfında bu olayları işlemenizi sağlayan Settings sınıfını tanımlar:

Settings.vb içindeki Settings sınıfı, oluşturulan sınıfın tamamını değil yalnızca kullanıcıya ait kodu görüntüleyen kısmi bir sınıftır. My.Settings nesnesini kullanarak uygulama ayarlarına erişme hakkında daha fazla bilgi için bkz. Access uygulama ayarları (.NET Framework).

Kullanıcının çalışma zamanında değiştirmiş olduğu kullanıcı kapsamlı ayarların (örneğin, formun konumu) değerleri user.config bir dosyada depolanır. Varsayılan değerler app.config'de kaydedilmeye devam eder.

Çalışma anında, örneğin uygulamayı test ederken kullanıcı kapsamındaki ayarlar değiştirilirse ve bu ayarları varsayılan değerlerine sıfırlamak istiyorsanız, Eşitle düğmesini seçin.

Ayarlara erişmek için My.Settings nesnesini ve varsayılan .settings dosyasını kullanmanızı öneririz. Ayarlara özellik atamak için Ayarlar Tasarımcısı kullanabilirsiniz ve ayrıca uygulama kapatılmadan önce kullanıcı ayarları otomatik olarak kaydedilir. Ancak Visual Basic uygulamanız ayarlara doğrudan erişebilir. Bu durumda, MySettings sınıfına erişmeniz ve projenin kökünde özel bir .settings dosyası kullanmanız gerekir. Aşağıdaki bölümde açıklandığı gibi, bir C# uygulaması için yaptığınız gibi, uygulamayı sonlandırmadan önce kullanıcı ayarlarını kaydetmeniz gerekir.

C'de çalışma zamanında uygulama ayarlarına erişme veya ayarları değiştirme#

C# gibi Visual Basic dışındaki dillerde, aşağıdaki Visual C# örneğinde gösterildiği gibi Settings sınıfına doğrudan erişmeniz gerekir.

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

Kullanıcı ayarlarını kalıcı hale getirmek için bu sarmalayıcı sınıfının Save yöntemini açıkça çağırmanız gerekir. Bunu genellikle ana formun Closing olay işleyicisinde yaparsınız. Aşağıdaki C# örneği, Save yöntemine yapılan çağrıyı gösterir.

Properties.Settings.Default.Save();

uygulama ayarlarına Settings sınıfı üzerinden erişme hakkında genel bilgi için bkz. Uygulama ayarlarına genel bakış (.NET Framework).

Uygulamaları .NET Framework'ten .NET'e geçirme

.NET Framework, bağlantı dizeleri ve kayıt sağlayıcı yapılandırması gibi uygulamanızın ayarlarını yüklemek için app.config dosyasını kullanır. Modern .NET, uygulama ayarları için appsettings.json dosyasını kullanır. app.config dosyalarını appsettings.jsondönüştürme hakkında daha fazla bilgi edinmek için bkz. .NET Framework'ten .NET'e yükselttikten sonra Modernleştirme.

İlgili içerik