SqlPersonalizationProvider.ResetState Yöntem

Tanım

Ad Alanı:

System.Web.UI.WebControls.WebParts

Bütünleştirilmiş Kod:

System.Web.dll

Belirtilen parametrelere göre temel alınan veri deposundan kişiselleştirme durumu bilgilerini siler.

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

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

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

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

Parametreler

scope

PersonalizationScope

PersonalizationScope Sorgulanacak kişiselleştirme bilgilerini gösteren bir. Bu değer olamaz null.

paths

String[]

Silinecek kapsamdaki Shared kişiselleştirme bilgilerinin yolları.

usernames

String[]

Silinecek kapsamdaki User kişiselleştirme bilgilerinin kullanıcı adları.

Döndürülenler

Int32

Silinen satır sayısı.

Özel durumlar

ArgumentException

paths veya usernames parametresi boş bir dizidir.

-veya- paths İlgili dizilerin içinde yer alan ve usernames parametreleri doğrulama kurallarını karşılamıyor.

ArgumentOutOfRangeException

Belirtilen scope sabit listesi üyesi PersonalizationScope değil.

Açıklamalar

Bu yöntemde joker karakter desteklenmez.

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

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

• scope parametresi ayarlanır ve paths parametre en az bir değer içerir. Bu birleşim, tarafından scopebelirtilen kişiselleştirme kapsamındaki belirtilen yol veya yollar için tüm Web Bölümleri kişiselleştirme verilerini siler.

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

• scope parametresi olarak ayarlanırUser, paths parametresi ise nullparametresi usernames en az bir değer içerir. Bu birleşim, içindeki kullanıcı veya kullanıcılarla usernamesilişkili tüm yollarda kullanıcı başına kişiselleştirme Web Bölümleri verileri siler.

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

• usernames parametresi olarak ayarlandığında Sharedparametresi sağlanamazscope.

• paths parametresi olmadığında usernames nullparametre birden fazla giriş içeremez.

paths İlgili dizilerin içinde yer alan ve usernames parametreleri aşağıdaki doğrulama kurallarını karşılamalıdır. Parametre dizilerinin herhangi bir üyesi için herhangi bir doğrulama kuralı başarısız olursa, bir ArgumentException özel durum oluşturulur. Doğrulama kuralları şunlardır:

• null değerlerine izin verilmez.

• Dize kırpıldıktan sonra boş bir dizeye ("") izin verilmez.

• parametresinde usernames yer alan hiçbir kullanıcı adı virgül içeremez.

• Parametredeki paths herhangi bir yolun uzunluğu 256 karakterden uzun olamaz.

• Parametredeki usernames herhangi bir kullanıcı adının uzunluğu 256 karakterden uzun olamaz.