SqlPersonalizationProvider.FindState Yöntem

Tanım

Ad Alanı:

System.Web.UI.WebControls.WebParts

Bütünleştirilmiş Kod:

System.Web.dll

Belirtilen kapsam ve parametrelere göre sıfır veya daha fazla PersonalizationStateInfotüretilmiş nesne içeren bir koleksiyon döndürür.

public:
 override 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 override 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);

override this.FindState : System.Web.UI.WebControls.WebParts.PersonalizationScope * System.Web.UI.WebControls.WebParts.PersonalizationStateQuery * int * int * int -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection

Public Overrides 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 belirten 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 toplam kayıt sayısı.

Döndürülenler

PersonalizationStateInfoCollection

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

Özel durumlar

ArgumentException

pageIndex, sıfırdan küçüktür.

-veya-

pageSize sıfırdan küçük veya sıfıra eşit.

-veya-

ve pageSize birleşimi pageIndex, Int32.MaxValue değerinden daha büyük bir değerle sonuç verir.

-veya-

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

-veya-

Değerin uzunluğu PathToMatch 256 karakterden uzun olduğunda değerin değeri 256 karakterdennull uzundur.

-veya-

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

-veya-

Değerin uzunluğu UsernameToMatch 256 karakterden uzun olduğunda değerin değeri 256 karakterdennull uzundur.

ArgumentOutOfRangeException

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

Açıklamalar

Döndürülen öğeler kümesi, döndürülecek kayıt sayısını denetleyen ve döndürülecek kayıtları denetleyen pageSize ve pageIndexpageIndex parametreleriyle pageSize kısıtlanır. Örneğin, pageIndex 0 ve 25'in biri pageSize ilk 25 oluşumu döndürürken pageIndex , 1 ve 25'in biri pageSize 26-50 oluşumlarını döndürür. Kullanılabilir tüm kayıtları getirmek istiyorsanız, 0 ve pageSize olarak MaxValueayarlayınpageIndex.

PersonalizationStateInfoTüretilmiş nesneler, her ikisi de artan düzende ve Usernameile sıralanmış Path alfabetik düzende döndürülü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, "~/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 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 nullquery veya ü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 özelliği 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 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 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:

• Shared kapsamı ile birlikte PathToMatch.

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