Aracılığıyla paylaş

SqlPersonalizationProvider.GetCountOfState Yöntem

Tanım

Ad Alanı:
System.Web.UI.WebControls.WebParts
Bütünleştirilmiş Kod:
System.Web.dll

Belirtilen scope parametre için var olan temel veri deposundaki satır sayısını döndürür.

public:
 override int GetCountOfState(System::Web::UI::WebControls::WebParts::PersonalizationScope scope, System::Web::UI::WebControls::WebParts::PersonalizationStateQuery ^ query);
public override int GetCountOfState(System.Web.UI.WebControls.WebParts.PersonalizationScope scope, System.Web.UI.WebControls.WebParts.PersonalizationStateQuery query);
override this.GetCountOfState : System.Web.UI.WebControls.WebParts.PersonalizationScope * System.Web.UI.WebControls.WebParts.PersonalizationStateQuery -> int
Public Overrides Function GetCountOfState (scope As PersonalizationScope, query As PersonalizationStateQuery) As Integer

Parametreler

scope
PersonalizationScope

PersonalizationScope Sorgulanacak kişiselleştirme bilgilerini gösteren bir. 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ı.

Özel durumlar

ArgumentException

PathToMatch değildirnull ve kırpmadan sonra boş bir dizedir ("").

-veya-

Değer olmayannull bir değer olduğunda uzunluğu PathToMatch 256 karakterden uzundur.

-veya-

UsernameToMatch değildirnull ve kırpmadan sonra boş bir dizedir.

-veya-

Değer olmayannull bir değer olduğunda uzunluğu UsernameToMatch 256 karakterden uzundur.

ArgumentOutOfRangeException

Belirtilen scope , numaralandırmadan PersonalizationScope geçerli bir değer değil.

Açıklamalar

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 işareti (*), 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 kullanabilirsiniz. Örneğin, "~/approot" PathToMatch ile başlayan tüm yolları bulmak için özelliği "~/approot%" olarak ayarlanır.

Benzer şekilde, kısmi bir kullanıcı adında joker karakter araması, özelliğin metin dizesinde herhangi bir noktada joker karakterin UsernameToMatch görünmesini sağlayabilir. Örneğin, "John" 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 query veya null üzerindeki query tüm özellikler ya da null varsayılan değerler döndürdüyse, belirtilen scope parametreyle eşleşen tüm kayıtlar döndürülür.

  • PathToMatch özelliği değilsenull, döndürülen kayıtlar da özellik değeriyle PathToMatch eşleşen yollara göre filtrelenir.

  • UsernameToMatch nulldeğilse, döndürülen 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, döndürülen 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 özelliğine LastActivityDate 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 etkin olmayan kullanıcılarla ilişkili durum kayıtlarının sayısını isteyebilir. Etkin olmayan özelleştirme kavramı olmadığından, döndürülen sayı sıfır olur.

Boş olmayan bir koleksiyon döndürme olasılığı olan parametre birleşimleri şunlardır:

Şunlara uygulanır