Özel Denetimler için Uygulama Ayarları

Özel denetimlerinize denetimler üçüncü taraf uygulamalarda barındırıldıklarında uygulama ayarlarını kalıcı yapma olanağı vermek için belirli görevleri tamamlamanız gerekir.

Application Ayarlar özelliği hakkındaki belgelerin çoğu, tek başına bir uygulama oluşturmakta olduğunuz varsayımı kapsamında yazılır. Ancak, diğer geliştiricilerin uygulamalarında barındıracakları bir denetim oluşturuyorsanız, denetiminizin ayarlarını düzgün bir şekilde kalıcı olması için birkaç ek adım atabilirsiniz.

Uygulama Ayarlar ve Özel Denetimler

Denetiminizin ayarlarını düzgün bir şekilde kalıcı olması için, 'den türetilen kendi ayrılmış uygulama ayarları sarmalayıcı sınıfını oluşturarak işlemi ApplicationSettingsBase kapsüllemektedir. Ayrıca, ana denetim sınıfının uygulaması IPersistComponentSettings gerekir. Arabiriminde birçok özelliğin yanı sıra iki yöntem vardır: LoadComponentSettings ve SaveComponentSettings . Visual Studio'da Windows Forms Tasarımcısı'Windows denetiminizi bir forma eklersanız, Windows Forms denetim başlatılmış olduğunda otomatik olarak çağrır; denetiminizin yönteminde kendinizi SaveComponentSettingsDispose çağırmanız gerekir.

Ayrıca, uygulama ayarlarının özel denetimler gibi tasarım zamanı ortamlarında düzgün çalışması için aşağıdakini Visual Studio:

  1. Oluşturucusu tek parametre olarak alan özel uygulama IComponent 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şturma, oluşturucu kullanarak özel denetiminizi iletir.

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

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

Ayarlar Anahtarları ve Paylaşılan Ayarlar

Bazı denetimler aynı formda birden çok kez kullanılabilir. Çoğu zaman, bu denetimlerin kendi bireysel ayarlarını kalıcı olarak devam etmesi gerekir. üzerinde SettingsKey özelliğiyle, bir formda bir denetimin birden çok sürümünü karartacak şekilde hareket etmek için benzersiz IPersistComponentSettings bir dize sebilirsiniz.

Uygulamanın en basit SettingsKey yolu, için Name denetimin özelliğini kullanmaktır. SettingsKey Denetimin ayarlarını yükleye veya kaydeden, değerini SettingsKey sınıfının SettingsKey özelliğine ApplicationSettingsBase iletirsiniz. Uygulama Ayarlar, kullanıcının ayarlarını XML'de kalıcı olduğunda bu benzersiz anahtarı kullanır. Aşağıdaki kod örneği, bir bölümün özelliği için bir ayar kaydeden adlı bir özel <userSettings>CustomControl1 denetimin örneğini nasıl ayalar? Text

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

bir denetimin değerine sahip olan örnekleri SettingsKey aynı ayarları paylaşır.

Ayrıca bkz.