Share via

Özel Denetimler için Uygulama Ayarları

  • Makale

Denetimler üçüncü taraf uygulamalarda barındırıldığında özel denetimlerinize uygulama ayarlarını kalıcı hale getirmek için belirli görevleri tamamlamanız gerekir.

Uygulama Ayarlar özelliğiyle ilgili belgelerin çoğu, tek başına uygulama oluşturduğunuz varsayımına göre yazılmıştır. Ancak, diğer geliştiricilerin uygulamalarında barındıracağı bir denetim oluşturuyorsanız, denetiminizin ayarlarını düzgün bir şekilde kalıcı hale getirmek için birkaç ek adım uygulamanız gerekir.

Uygulama Ayarlar ve Özel Denetimler

Denetiminizin ayarlarını düzgün bir şekilde kalıcı hale getirmek için, öğesinden ApplicationSettingsBasetüretilen kendi ayrılmış uygulama ayarları sarmalayıcı sınıfını oluşturarak işlemi kapsüllemelidir. Ayrıca, ana denetim sınıfının uygulamasının IPersistComponentSettingsolması gerekir. Arabirim, çeşitli özelliklerin yanı sıra iki yöntem ve SaveComponentSettingsiçerirLoadComponentSettings. Visual Studio'daki Windows Forms Tasarım Aracı kullanarak denetiminizi bir forma eklerseniz, denetim başlatıldığında Windows Forms otomatik olarak çağrılırLoadComponentSettings; denetiminizin yönteminde Dispose kendinizi çağırmanız SaveComponentSettings gerekir.

Ayrıca, visual studio gibi tasarım zamanı ortamlarında özel denetimlerin uygulama ayarlarının düzgün çalışması için aşağıdakileri uygulamanız gerekir:

  1. Tek bir parametre olarak alan IComponent bir oluşturucuya sahip özel uygulama ayarları sınıfı. Tüm uygulama ayarlarınızı kaydetmek ve yüklemek için bu sınıfı kullanın. Bu sınıfın yeni bir örneğini oluşturduğunuzda, oluşturucuyu kullanarak özel denetiminizi geçirin.

  2. Denetim oluşturulduktan ve formun olay işleyicisinde olduğu gibi bir forma yerleştirildikten sonra bu özel ayarlar sınıfını Load oluşturun.

Özel ayarlar sınıfı oluşturma yönergeleri için bkz. Nasıl yapılır: Uygulama Ayarlar Oluşturma.

Ayarlar Anahtarları ve Paylaşılan Ayarlar

Bazı denetimler aynı formda birden çok kez kullanılabilir. Çoğu zaman, bu denetimlerin kendi ayarlarını kalıcı hale getirmek istersiniz. SettingsKey üzerinde özelliğiyleIPersistComponentSettings, bir formdaki denetimin birden çok sürümünün belirsiz olmasını sağlayan benzersiz bir dize sağlayabilirsiniz.

Uygulamanın SettingsKey en basit yolu, için denetimin özelliğini kullanmaktır NameSettingsKey. Denetimin ayarlarını yüklediğinizde veya kaydettiğinizde değerini sınıfının özelliğine SettingsKeyApplicationSettingsBase geçirirsinizSettingsKey. Uygulama Ayarlar, kullanıcının ayarlarını XML olarak kalıcı hale getirmek için bu benzersiz anahtarı kullanır. Aşağıdaki kod örneği, bir <userSettings> bölümün özelliği için Text bir ayar kaydeden adlı CustomControl1 özel bir denetimin örneğini nasıl arayabileceğini gösterir.

<userSettings>
    <CustomControl1>
        <setting name="Text" serializedAs="string">
            <value>Hello, World</value>
        </setting>
    </CustomControl1>
</userSettings>

için SettingsKey değer sağlamayan bir denetimin tüm örnekleri aynı ayarları paylaşır.

Ayrıca bkz.