PersonalizationProvider.FindState Yöntem

  • Başvuru

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, kapsam ve belirli sorgu parametrelerine göre sıfır veya daha fazla PersonalizationStateInfotüretilmiş nesne içeren bir koleksiyon döndürür.

public:
 abstract System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindState(System::Web::UI::WebControls::WebParts::PersonalizationScope scope, System::Web::UI::WebControls::WebParts::PersonalizationStateQuery ^ query, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);
public abstract System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindState (System.Web.UI.WebControls.WebParts.PersonalizationScope scope, System.Web.UI.WebControls.WebParts.PersonalizationStateQuery query, int pageIndex, int pageSize, out int totalRecords);
abstract member FindState : System.Web.UI.WebControls.WebParts.PersonalizationScope * System.Web.UI.WebControls.WebParts.PersonalizationStateQuery * int * int * int -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection
Public MustOverride Function FindState (scope As PersonalizationScope, query As PersonalizationStateQuery, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As PersonalizationStateInfoCollection

Parametreler

scope
PersonalizationScope

PersonalizationScope Sorgulanacak kişiselleştirme bilgilerini içeren bir. Bu değer olamaz null.

query
PersonalizationStateQuery

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

pageIndex
Int32

Sorgunun başlatıldığı konum.

pageSize
Int32

Döndürülecek kayıt sayısı.

totalRecords
Int32

Kullanılabilir kayıtların toplam sayısı.

Döndürülenler

PersonalizationStateInfoCollection

PersonalizationStateInfoCollection Sıfır veya daha fazla PersonalizationStateInfotüretilmiş nesne içeren.

Açıklamalar

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

Döndürülen öğe kümesi, döndürülecek kayıt sayısını ve döndürülecek pageIndex kayıtları ayarlayan pageSize ve pageSize parametreleriyle pageIndex kısıtlanır. Örneğin, pageIndex 0 ve 25'in bir pageSize değeri ilk 25 oluşumu döndürürken pageIndex , 1 ve 25'lik bir pageSize değer 26-50 arası oluşumları döndürür. Kullanılabilir tüm kayıtları almak istiyorsanız, 0 ve pageSize olarak MaxValueayarlayınpageIndex.

PersonalizationStateInfoTüretilmiş nesneler alfabetik düzende döndürülür ve her ikisi de artan düzende ve Username özellik değerlerinin Path bir bileşimine göre sıralanır.

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 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 değerle PathToMatch eşleşen yollara göre filtrelenir.

  • UsernameToMatch Özellik değilsenull, 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 belirli bir kullanıcı adıyla ilişkili bir kişiselleştirme durumu kayıtları kümesi isteyebilir. Kullanıcı adları paylaşılan bilgilerle ilişkilendirilmediğinden, döndürülen koleksiyon boş olur.

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

Şunlara uygulanır