PersonalizationProvider.GetCountOfState 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ındığında, temel alınan veri deposunda belirtilen kapsam içinde bulunan satır sayısını döndürür.

public:
 abstract int GetCountOfState(System::Web::UI::WebControls::WebParts::PersonalizationScope scope, System::Web::UI::WebControls::WebParts::PersonalizationStateQuery ^ query);

public abstract int GetCountOfState (System.Web.UI.WebControls.WebParts.PersonalizationScope scope, System.Web.UI.WebControls.WebParts.PersonalizationStateQuery query);

abstract member GetCountOfState : System.Web.UI.WebControls.WebParts.PersonalizationScope * System.Web.UI.WebControls.WebParts.PersonalizationStateQuery -> int

Public MustOverride Function GetCountOfState (scope As PersonalizationScope, query As PersonalizationStateQuery) As Integer

Parametreler

scope

PersonalizationScope

PersonalizationScope Sorgulanacak kişiselleştirme bilgilerinden biri. Bu değer olamaz null.

query

PersonalizationStateQuery

Sorgu PersonalizationStateQuery içeren bir. Bu değer olabilir null.

Döndürülenler

Int32

Belirtilen scope parametre için temel alınan veri deposundaki satır sayısı.

Açıklamalar

Bu yöntem, kişiselleştirme verilerinin sayılarını almak için bir yönetim yönteminin soyut tanımıdır. Türetilmiş uygulamalar aşağıda açıklanan mantığı izlemelidir.

Bu yöntem, sorgu joker karakterlerini temel alınan veri deposuna geçirir. Joker karakter desteği şu anda her sağlayıcının yıldız (*) , yüzde simgesi (%) veya alt çizgi (_) gibi karakterleri nasıl işlediğine bağlıdır.

Normalde SQL uyumlu veri depoları için kısmi bir yolda joker karakter özelliğindeki arama dizesi metninin PathToMatch başında, sonunda veya ortasında görünecek şekilde joker karakter araması yapabilirsiniz. Örneğin, "~/vdir" PathToMatch ile başlayan tüm yolları bulmak için özelliği "~/vdir%" olarak ayarlanır.

Benzer şekilde, kısmi bir kullanıcı adında joker karakter araması, özelliğin metin dizesinde UsernameToMatch herhangi bir noktada joker karakterin görünmesini sağlayabilir. Örneğin, "Ali" UsernameToMatch ile başlayan tüm kullanıcı adlarını bulmak için parametresi "John%" gibi görünür.

Aşağıdaki sorgu kısıtlamaları geçerlidir:

• Yalnızca scope sağlanmışsa ve querynull değeri veya varsayılan değerleri döndüren null tüm özellikler query ise, belirtilen scope parametreyle eşleşen tüm kayıtlar sayılır.

• PathToMatch özelliği değilsenull, sayılan kayıtlar da değerle eşleşen PathToMatch yollara göre filtrelenir.

• UsernameToMatch özelliği değilsenull, sayılan kayıtlar da özellik değeriyle UsernameToMatch eşleşen kullanıcı adlarına göre filtrelenir.

• Özelliği ile UserInactiveSinceDate eşit MaxValuedeğilse, sayılan kayıtlar da yalnızca etkin olmayan kullanıcılarla ilişkili kayıtları döndürecek şekilde filtrelenir. Karşılaştırma, özelliğin LastActivityDate özelliğe eşit UserInactiveSinceDate veya ondan küçük olduğu kayıtları içerir.

Bu yöntemin sorgu parametrelerinin birleşimlerini doğrulamadığını unutmayın. Örneğin, kod paylaşılan kapsamdaki belirli bir kullanıcı adıyla ilişkili kişiselleştirme durumu kayıtlarının sayısını isteyebilir. Kullanıcı adları paylaşılan bilgilerle ilişkilendirilmediğinden, döndürülen sayı sıfır olur.

Sıfır olmayan bir sayı döndürme olasılığı olan parametre birleşimleri şunlardır:

• Shared kapsamı özelliğiyle PathToMatch birlikte.

• Userkapsamı, , UsernameToMatchve UserInactiveSinceDate özelliklerinin herhangi birinin veya tümünün PathToMatchdeğerleriyle birlikte.