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ğerin uzunluğu PathToMatch 256 karakterden uzunsa, değer 256 karakterden uzundurnull.

-veya-

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

-veya-

Değerin uzunluğu UsernameToMatch 256 karakterden uzunsa, değer 256 karakterden uzundurnull.

ArgumentOutOfRangeException

Belirtilen scope sabit listesi geçerli PersonalizationScope 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 (*) , 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, "~/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 dizesindeki 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ğinden LastActivityDate küçük veya buna eşit UserInactiveSinceDate olduğu kayıtları içerir.

Bu yöntemin sorgu parametrelerinin bileş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 olacaktır.

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

• Shared kapsamı ile birlikte PathToMatch.

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