PersonalizationAdministration.FindUserState Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Belirtilen parametrelere göre kullanıcı başına kişiselleştirme durumu bilgilerini içeren bir koleksiyon döndürür.
Aşırı Yüklemeler
| FindUserState(String, String) |
Kullanıcı adına ve sayfa yoluna göre kullanıcı başına kişiselleştirme durumu bilgilerini içeren bir koleksiyon döndürür. |
| FindUserState(String, String, Int32, Int32, Int32) |
Belirtilen parametrelere göre kullanıcı başına kişiselleştirme durumu bilgilerini içeren bir koleksiyon döndürür. |
FindUserState(String, String)
Kullanıcı adına ve sayfa yoluna göre kullanıcı başına kişiselleştirme durumu bilgilerini içeren bir koleksiyon döndürür.
public:
static System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindUserState(System::String ^ pathToMatch, System::String ^ usernameToMatch);public static System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindUserState (string pathToMatch, string usernameToMatch);static member FindUserState : string * string -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollectionPublic Shared Function FindUserState (pathToMatch As String, usernameToMatch As String) As PersonalizationStateInfoCollectionParametreler
- pathToMatch
- String
Eşleştirecek sayfanın yolu.
- usernameToMatch
- String
Sayfayla ilişkilendirilmiş kişiselleştirme verilerini içeren eşleşen kullanıcı adı.
Döndürülenler
PersonalizationStateInfoCollection Kullanıcı başına kişiselleştirme durumu bilgilerini içeren bir.
Özel durumlar
pathToMatch veya usernameToMatch kırpmadan önce veya sonra boş bir dize ("").
-veya-
Yapılandırmada tanımlanan bir 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.
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ı.
Örnekler
Aşağıdaki kod örneğinde yönteminin nasıl kullanılacağı gösterilmektedir FindUserState . Tam örnek, sınıfa PersonalizationAdministration genel bakış konusunda bulunabilir.
Önemli
Bu örnekte, olası bir güvenlik tehdidi olan kullanıcı girişini kabul eden bir metin kutusu vardır. Varsayılan olarak, ASP.NET Web sayfaları kullanıcı girişinin betik veya HTML öğeleri içermediğini doğrular. Daha fazla bilgi için bkz. Betik Açıklarına Genel Bakış.
protected void Button1_Click(object sender, EventArgs e)
{
if (TextBox3.Text != null)
{
PersonalizationStateInfoCollection findresult;
findresult = PersonalizationAdministration.FindUserState(null, TextBox3.Text);
if (findresult.Count != 0)
{
Label4.Text = findresult.Count + " user(s) found";
Label4.Visible = true;
}
else
{
Label4.Text = "No users found.";
Label4.Visible = true;
}
}
else
{
Label4.Text = "You must enter a user name to find.";
}
}
Açıklamalar
Bu yöntem, parametre değerinin UserPersonalizationStateInfo bir sayfanın yoluyla eşleştiği pathToMatch ve usernameToMatch bu sayfayla ilişkilendirilmiş kişiselleştirme verilerinin bulunduğu bir kullanıcı adıyla eşleştiği bir örnek koleksiyonu döndürür. Koleksiyon yalnızca UserPersonalizationStateInfo ö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 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 özellik "John%" gibi görünü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 ile kullanıcı adı birleşimine göre artan düzende sıralanır. Koleksiyondaki nesnelerin sıralaması sağlayıcı tarafından belirlenir.
Hem hem de pathToMatchusernameToMatch olabilir null.
usernameToMatch Microsoft SQL Server çalıştıranlar gibi bazı veri depoları joker karakter olarak virgüle izin vermediğinden parametre virgül (,) içerebilir.
Ayrıca bkz.
- WebPartPersonalization
- Web Bölümleri Denetimlerini ASP.NET
- Web Bölümleri Kişiselleştirmeye Genel Bakış
- İzlenecek yol: Kullanıcı Denetimi ile Web Bölümleri Kişiselleştirmeyi Uygulama
- Web Bölümlerini Kişiselleştirme
Şunlara uygulanır
FindUserState(String, String, Int32, Int32, Int32)
Belirtilen parametrelere göre kullanıcı başına kişiselleştirme durumu bilgilerini içeren bir koleksiyon döndürür.
public:
static System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindUserState(System::String ^ pathToMatch, System::String ^ usernameToMatch, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);public static System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindUserState (string pathToMatch, string usernameToMatch, int pageIndex, int pageSize, out int totalRecords);static member FindUserState : string * string * int * int * int -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollectionPublic Shared Function FindUserState (pathToMatch As String, usernameToMatch As String, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As PersonalizationStateInfoCollectionParametreler
- pathToMatch
- String
Eşleştirecek sayfanın yolu.
- usernameToMatch
- String
Sayfayla ilişkilendirilmiş kişiselleştirme verilerini içeren eşleşen kullanıcı adı.
- 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 sayı veya kayıt.
Döndürülenler
PersonalizationStateInfoCollection Kullanıcı başına kişiselleştirme durumu bilgilerini içeren bir.
Özel durumlar
pathToMatch veya usernameToMatch kırpmadan önce veya sonra boş bir dize ("").
-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 bir 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.
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ı.
Örnekler
Aşağıdaki kod örneğinde yönteminin nasıl kullanılacağı gösterilmektedir FindUserState . Tam örnek, sınıfa PersonalizationAdministration genel bakış konusunda bulunabilir.
Önemli
Bu örnekte, olası bir güvenlik tehdidi olan kullanıcı girişini kabul eden bir metin kutusu vardır. Varsayılan olarak, ASP.NET Web sayfaları kullanıcı girişinin betik veya HTML öğeleri içermediğini doğrular. Daha fazla bilgi için bkz. Betik Açıklarına Genel Bakış.
protected void Button1_Click(object sender, EventArgs e)
{
if (TextBox3.Text != null)
{
PersonalizationStateInfoCollection findresult;
findresult = PersonalizationAdministration.FindUserState(null, TextBox3.Text);
if (findresult.Count != 0)
{
Label4.Text = findresult.Count + " user(s) found";
Label4.Visible = true;
}
else
{
Label4.Text = "No users found.";
Label4.Visible = true;
}
}
else
{
Label4.Text = "You must enter a user name to find.";
}
}
Açıklamalar
Bu yöntem, parametre değerinin UserPersonalizationStateInfo bir sayfanın yoluyla eşleştiği pathToMatch ve usernameToMatch bu sayfayla ilişkilendirilmiş kişiselleştirme verilerinin bulunduğu bir kullanıcı adıyla eşleştiği bir örnek koleksiyonu döndürür. Koleksiyon yalnızca UserPersonalizationStateInfo ö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 karakterleri yıldız (*) , yüzde simgesi (%) veya alt çizgi (_) olarak 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 özellik "John%" gibi görünü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 ile kullanıcı adı birleşimine göre artan düzende sıralanır. Koleksiyondaki nesnelerin sırası sağlayıcı tarafından belirlenir.
Hem hem de pathToMatchusernameToMatch olabilir null.
usernameToMatch Microsoft SQL Server çalıştıranlar gibi bazı veri depoları joker karakter olarak virgüle izin vermediğinden parametre virgül (,) içerebilir.
Döndürülen veriler ve ile pageIndex kısıtlanır; 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 ve pageSize 25 olarak ayarlanmışsapageIndex, 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ş olacaktır.
totalRecords parametresi, kullanılabilir kayıtların toplam sayısını döndürür.
Ayrıca bkz.
- WebPartPersonalization
- Web Bölümleri Denetimlerini ASP.NET
- Web Bölümleri Kişiselleştirmeye Genel Bakış
- İzlenecek yol: Kullanıcı Denetimi ile Web Bölümleri Kişiselleştirmeyi Uygulama
- Web Bölümlerini Kişiselleştirme
Şunlara uygulanır
Geri Bildirim
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz. https://aka.ms/ContentUserFeedback.
Gönderin ve geri bildirimi görüntüleyin