IPersistComponentSettings.SettingsKey Özellik

Tanım

Ad Alanı:

System.Configuration

Bütünleştirilmiş Kod:

System.Configuration.ConfigurationManager.dll

Kaynak:

IPersistComponentSettings.cs

Denetimin geçerli örneği için uygulama ayarları anahtarının değerini alır veya ayarlar.

public:
 property System::String ^ SettingsKey { System::String ^ get(); void set(System::String ^ value); };

public string SettingsKey { get; set; }

member this.SettingsKey : string with get, set

Public Property SettingsKey As String

Özellik Değeri

String

String Denetimin geçerli örneği için ayarlar anahtarını içeren.

Açıklamalar

SettingsKey Aynı sarmalayıcı sınıfının birden çok örneği olduğunda uygulama ayarları özellikleri gruplarının belirsiz olmasını sağlamak için özelliğini kullanın. Örneğin, bir denetim ilişkili sarmalayıcı sınıfı içeriyorsa, aynı denetimin birden çok örneğinin aynı uygulamaya yerleştirilmesi genellikle sarmalayıcı sınıfının birden çok örneğine neden olur. Ayarlar anahtarı yalnızca yapılandırma verileri örnek bazında farklılık gösterdiğinde gereklidir; örneğin, dinamik olarak konumlandırılan denetimlerin konumu.

Aşağıdaki genel kurallar kullanımı SettingsKeyiçin geçerlidir:

• Herhangi bir sınıf gibi bir denetim, öğesinden ApplicationSettingsBasetüretilmiş sıfır veya daha fazla uygulama ayarları sınıfı içerebilir. Her ayarlar sınıfı kendi ApplicationSettingsBase.SettingsKey özelliğini içerir ve bu da bu sınıfın birden çok örneğini belirlemeye yardımcı olur.

• Denetim, örnek başına verilerini ve paylaşılan verilerini farklı ayarlar sınıflarına ayırmalıdır.

• Örnek başına yapılandırma verilerine sahip bir denetim için, get özelliğin SettingsKey erişimcisi varsayılan olarak Name denetimin öğesine ayarlanmalıdır. Çoğu durumda denetimin adı bir uygulama içinde benzersiz olur. Denetim yalnızca paylaşılan yapılandırma verileri içeriyorsa, get varsayılan olarak olmalıdır null.

• Bu özelliğin set erişimcisi, örnek başına ve paylaşılan yapılandırma verilerini içeren ayarlar sınıflarını ayırt etmek için uygulanmalıdır. Örnek başına veri içeren her ayarlar sınıfı için yalnızca set ayarlar sınıfının özelliğine ApplicationSettingsBase.SettingsKey geçiş yapmalıdır. Paylaşılan verileri içeren ayarlar sınıfları için, set bu ayarlar sınıfı için hiçbir eylem gerçekleştirmemelidir.

Ayrıca bkz.

• SaveComponentSettings()
• SettingsKey
• Özel Denetimler için Uygulama Ayarları