PersonalizationProvider.ResetState Yöntem

Tanım

Ad Alanı:

System.Web.UI.WebControls.WebParts

Bütünleştirilmiş Kod:

System.Web.dll

Türetilmiş bir sınıfta geçersiz kılınırken, belirtilen parametrelere göre temel alınan veri deposundan kişiselleştirme durumunu siler.

public:
 abstract int ResetState(System::Web::UI::WebControls::WebParts::PersonalizationScope scope, cli::array <System::String ^> ^ paths, cli::array <System::String ^> ^ usernames);

public abstract int ResetState (System.Web.UI.WebControls.WebParts.PersonalizationScope scope, string[] paths, string[] usernames);

abstract member ResetState : System.Web.UI.WebControls.WebParts.PersonalizationScope * string[] * string[] -> int

Public MustOverride Function ResetState (scope As PersonalizationScope, paths As String(), usernames As String()) As Integer

Parametreler

scope

PersonalizationScope

Sıfırlanacak PersonalizationScope kişiselleştirme bilgilerden biri. Bu değer null olamaz.

paths

String[]

Kişiselleştirme bilgileri silinecek yollar.

usernames

String[]

Silinecek kişiselleştirme bilgileri için kullanıcı adları.

Döndürülenler

Int32

Silinen satır sayısı.

Açıklamalar

Bu yöntem, kişiselleştirme verilerini silmek için kullanılan bir yönetim yönteminin soyut tanımıdır. Türetilmiş uygulamalar aşağıda açıklanan mantığı izlemeli.

Bu yöntem, joker karakter aramalarını desteklemez. Kişiselleştirme sağlayıcısı, işlem durumuna sahip bir veri deposuna yönelik verileri açığa çıkarırsa, bu yöntemin işlemlerini tek bir atomik işlem olarak gerçekleştirmesi gerekir.

Yalnızca aşağıdaki parametre birleşimlerine izin verilir:

• scopeparametresi ayarlanır ve diğer tüm parametreler olarak null ayarlanır. Bu birleşim, tarafından Web Bölümleri kapsamıyla ilişkili tüm özelleştirme verilerini scope siler.

• parametresi scope ayarlanır ve parametresi en az bir değer paths içerir. Bu birleşim, Web Bölümleri kapsamda belirtilen yol veya yollar için tüm özelleştirme verilerini scope siler.

• parametresi scope olarak User ayarlanır, parametre ayarlanır ve yalnızca bir değer paths içerir ve parametre en az bir değer usernames içerir. Bu birleşim, içinde bulunan kullanıcı Web Bölümleri ilgili yol için tüm kullanıcı kişiselleştirme verilerini usernames siler.

• parametresi scope olarak User ayarlanır, parametresi olarak ayarlanır ve parametresi paths en az bir değer null usernames içerir. Bu birleşim, içinde bulunan kullanıcı veya Web Bölümleri tüm yollarda tüm kullanıcı başına kişiselleştirme verilerini usernames siler.

Parametre değerlerinin diğer bileşimleri geçersizdir ve bir özel durum ArgumentException oluşturur. Özellikle aşağıdaki iki birleşime izin verilmez:

• usernamesparametresi olarak ayarlanırken scope Shared sağlanamıyor.

• parametresi paths değilken, parametresi birden fazla usernames girdi null içeramaz.

İlgili paths usernames dizilerin içinde yer alan tüm ve parametre değerleri aşağıdaki doğrulama kurallarına uygun olmalıdır. Parametre dizilerinin herhangi bir üyesi için doğrulama kuralları başarısız olursa bir ArgumentException özel durum oluşturur. Doğrulama kuralları:

• null değerlere izin verilmez.

• Boş bir dizeye ("") izin verilmez. Boş bir dize denetimi gerçekleştirmeden önce parametreler kırpıldı olmalıdır.

• parametresi usernames virgül (,) içere değildir.

• Parametrenin paths uzunluğu, bir veritabanı için 256 karakterden SQL olamaz.

• Parametrenin usernames uzunluğu, bir veritabanı için 256 karakterden SQL olamaz.