PersonalizationDictionary.Add(String, PersonalizationEntry) Yöntem

Tanım

Ad Alanı:

System.Web.UI.WebControls.WebParts

Bütünleştirilmiş Kod:

System.Web.dll

Kişiselleştirme sözlüğüne kişiselleştirme girdileri ekler.

public:
 virtual void Add(System::String ^ key, System::Web::UI::WebControls::WebParts::PersonalizationEntry ^ value);

public virtual void Add (string key, System.Web.UI.WebControls.WebParts.PersonalizationEntry value);

abstract member Add : string * System.Web.UI.WebControls.WebParts.PersonalizationEntry -> unit
override this.Add : string * System.Web.UI.WebControls.WebParts.PersonalizationEntry -> unit

Public Overridable Sub Add (key As String, value As PersonalizationEntry)

Parametreler

key

String

Durum bilgisi parçasının benzersiz tanımlayıcısı.

value

PersonalizationEntry

Kişiselleştirme sözlüğüne eklenecek bir durum bilgisi parçası. Bu değer olabilir null.

Özel durumlar

ArgumentException

key , sözlükte zaten bulunan bir anahtarın kopyasıdır.

-veya-

key boş bir dize ("") veya kırpma işlemi boş bir dizeyle sonuçlanır key .

-veya-

value bir PersonalizationEntrydeğildir.

ArgumentNullException

key, null değeridir.

-veya-

value, null değeridir.

Açıklamalar

Bu yöntemi çağırabilir, özel durum bilgilerinin çeşitli parçalarını durum nesnesine yerleştirebilir ve durum değeriyle ilişkili kapsamı belirtebilirsiniz. Denetim WebPartManager kapsam içinde Shared olduğunda, kapsam veya User kapsamla Shared ilişkili ad ve durum bilgileri ekleyebilirsiniz. Kapsamda User , yalnızca kapsamla User ilişkili ad ve durum bilgileri ekleyebilirsiniz.

Ancak, sayfanın kapsamı ne olursa olsun veya kapsamına sahip UserShared özellikleri kullanarak Save tüm özellikleri sözlüğe eklemek iyi bir uygulamadır.

.NET Framework, özellikleri yalnızca uygun olduğunda kapsamla Shared kaydeder. Başka bir deyişle, sayfa User kapsam dahilindeyken başlangıçta kapsama eklenen Shared bir WebPart denetim daha sonra kaydedildiğinde paylaşılan özellikler kaydedilmez. Aksi bir senaryoda, kapsamdaki sayfaya User bir WebPart denetim eklendiyse ve denetim daha sonra sayfa kapsam dahilindeyken Shared kaydedilirse, özel paylaşılan özellik değerleri kaydedilir (özel kullanıcı kapsamlı özelliklerle birlikte). Kişiselleştirme verileri ve paylaşılan ve kullanıcı kapsamına sahip özelliklerin sayfanın kişiselleştirme kapsamından nasıl etkilendiği hakkında ayrıntılı bilgi için Web Bölümleri Kişiselleştirmeye Genel Bakış konusuna bakın.

Herhangi bir koleksiyonda olduğu gibi bu yöntem de koleksiyon sayısını bir artırır ve koleksiyonda şu anda etkin olan tüm numaralandırıcılar geçersiz kılınmalıdır.

Ayrıca bkz.

• Web Bölümleri Kişiselleştirmeye Genel Bakış