Aracılığıyla paylaş

PersonalizationAdministration.FindSharedState Yöntem

Tanım

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

Belirtilen parametrelere göre paylaşılan kişiselleştirme durumu bilgilerinden oluşan bir koleksiyon döndürür.

Aşırı Yüklemeler

Name Description
FindSharedState(String)

Belirtilen yola göre paylaşılan kişiselleştirme durumu bilgilerini içeren bir koleksiyon döndürür.
FindSharedState(String, Int32, Int32, Int32)

Belirtilen parametrelere göre paylaşılan kişiselleştirme durumu bilgilerinden oluşan bir koleksiyon döndürür.

FindSharedState(String)

Belirtilen yola göre paylaşılan kişiselleştirme durumu bilgilerini içeren bir koleksiyon döndürür.

public:
 static System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindSharedState(System::String ^ pathToMatch);
public static System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindSharedState(string pathToMatch);
static member FindSharedState : string -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection
Public Shared Function FindSharedState (pathToMatch As String) As PersonalizationStateInfoCollection

Parametreler

pathToMatch
String

Eşleşecek sayfanın yolu.

Döndürülenler

PersonalizationStateInfoCollection

PersonalizationStateInfoCollection Paylaşılan kişiselleştirme durumu bilgilerini içeren bir.

Özel durumlar

ArgumentException

pathToMatch , kırpmadan önce veya sonra boş bir dizedir ("").

-veya-

Yapılandırmada tanımlanan kişiselleştirme sağlayıcısının sağlayıcısı doğru türde değil.

-veya-

Herhangi bir parametrenin dizesinin uzunluğu 256 karakterden uzundur.

ConfigurationErrorsException

Yapılandırılan kişiselleştirme sağlayıcılarından birinin örneğini oluşturmaya ve başlatmaya çalışırken bir yapılandırma özel durumu oluştu.

-veya-

Yapılandırmada tanımlanan varsayılan kişiselleştirme sağlayıcısı bulunamadı.

Açıklamalar

Bu yöntem, değerin UserPersonalizationStateInfo paylaşılan kişiselleştirme durumu verilerini içeren bir sayfanın yolu ile eşleştiği pathToMatch bir örnek koleksiyonu döndürür. Koleksiyon yalnızca SharedPersonalizationStateInfo örnekleri içerir.

Bu yöntem parametre joker karakterlerini temel alınan kişiselleştirme sağlayıcısına geçirir, dolayısıyla veri deposunun bu karakterleri nasıl işlediği, 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, "~/vdir" PathToMatch ile başlayan tüm yolları bulmak için özelliği "~/vdir%" olarak ayarlanır.

Varsayılan kişiselleştirme sağlayıcısı kullanılarak, PersonalizationStateInfotüretilmiş nesneler alfabetik düzende döndürülür ve yol ve kullanıcı adı birleşimine göre artan düzende sıralanır. Koleksiyondaki nesnelerin sıralaması sağlayıcı tarafından belirlenir.

pathToMatch parametresi olabilirnull. olarak ayarlanırsa null, sorgular gerçekleştirilirken parametresi yoksayılır.

Ayrıca bkz.

Şunlara uygulanır

FindSharedState(String, Int32, Int32, Int32)

Belirtilen parametrelere göre paylaşılan kişiselleştirme durumu bilgilerinden oluşan bir koleksiyon döndürür.

public:
 static System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindSharedState(System::String ^ pathToMatch, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);
public static System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindSharedState(string pathToMatch, int pageIndex, int pageSize, out int totalRecords);
static member FindSharedState : string * int * int * int -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection
Public Shared Function FindSharedState (pathToMatch As String, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As PersonalizationStateInfoCollection

Parametreler

pathToMatch
String

Eşleşecek sayfanın yolu.

pageIndex
Int32

Döndürülecek sonuç sayfasının sıfır tabanlı dizini.

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 Paylaşılan kişiselleştirme durumu bilgilerini içeren bir.

Özel durumlar

ArgumentException

pathToMatch kırpmadan önce veya sonra boş bir dizedir ("").

-veya-

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 pageIndexInt32.MaxValue değerini aşıyor.

-veya-

Yapılandırmada tanımlanan kişiselleştirme sağlayıcısının sağlayıcısı doğru türde değil.

-veya-

Herhangi bir parametrenin dizesinin uzunluğu 256 karakterden uzundur.

ConfigurationErrorsException

Yapılandırılan kişiselleştirme sağlayıcılarından birinin örneğini oluşturmaya ve başlatmaya çalışırken bir yapılandırma özel durumu oluştu.

-veya-

Yapılandırmada tanımlanan varsayılan kişiselleştirme sağlayıcısı bulunamadı.

Açıklamalar

Bu yöntem, değerin UserPersonalizationStateInfo paylaşılan kişiselleştirme durumu verilerini içeren bir sayfanın yolu ile eşleştiği pathToMatch bir örnek koleksiyonu döndürür. Koleksiyon yalnızca SharedPersonalizationStateInfo örnekleri içerir.

Bu yöntem parametre joker karakterlerini temel alınan kişiselleştirme sağlayıcısına geçirir, dolayısıyla veri deposunun bu karakterleri nasıl işlediği, 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, "~/vdir" PathToMatch ile başlayan tüm yolları bulmak için özelliği "~/vdir%" olarak ayarlanır.

Varsayılan kişiselleştirme sağlayıcısı kullanılarak, PersonalizationStateInfotüretilmiş nesneler alfabetik düzende döndürülür ve yol ve kullanıcı adı birleşimine göre artan düzende sıralanır. Koleksiyondaki nesnelerin sırası sağlayıcı tarafından belirlenir.

pathToMatch parametresi olabilirnull. olarak ayarlanırsa null, sorgular gerçekleştirilirken parametresi yoksayılır.

Döndürülen veriler ve ile pageIndex kısıtlanır ve burada pageIndex hangi kayıtların döndürüleceği ve pageSize döndürülecek kayıt sayısını pageSizedenetler. Örneğin, 0 olarak pageSize ve 25 olarak ayarlandıysapageIndex, döndürülen veriler ilk 25 girdi olacaktır. 1 olarak ayarlanmış ve pageSize 25 olarak ayarlanmışsapageIndex, döndürülen veriler 26 ile 50 arasında girişler olacaktır. totalRecords parametresi, kullanılabilir kayıtların toplam sayısını döndürür.

Ayrıca bkz.

Şunlara uygulanır