PersonalizationAdministration.FindUserState Yöntem

Tanım

Ad Alanı:

System.Web.UI.WebControls.WebParts

Bütünleştirilmiş Kod:

System.Web.dll

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

Name	Description
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.PersonalizationStateInfoCollection

Public Shared Function FindUserState (pathToMatch As String, usernameToMatch As String) As PersonalizationStateInfoCollection

Parametreler

pathToMatch

String

Eşleşecek sayfanın yolu.

usernameToMatch

String

Sayfayla ilişkilendirilmiş kişiselleştirme verilerine sahip eşleşen kullanıcı adı.

Döndürülenler

PersonalizationStateInfoCollection

PersonalizationStateInfoCollection Kullanıcı başına kişiselleştirme durumu bilgilerini içeren bir.

Özel durumlar

ArgumentException

pathToMatch veya usernameToMatch 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ı.

Örnekler

Aşağıdaki kod örneği, yönteminin FindUserState nasıl kullanılacağını gösterir. 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şkili 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 kullanabilirsiniz. Ö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 dizesinde 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 ve 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üllere izin vermediğinden parametresi virgül (,) içerebilir.

Ayrıca bkz.

• WebPartPersonalization
• Web Bölümleri Denetimlerini ASP.NET
• Web Bölümlerini Kişiselleştirmeye Genel Bakış
• İzlenecek yol: Kullanıcı Denetimi ile Web Bölümleri Kişiselleştirmesi Uygulama
• Web Bölümlerini Kişiselleştirme

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.PersonalizationStateInfoCollection

Public Shared Function FindUserState (pathToMatch As String, usernameToMatch As String, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As PersonalizationStateInfoCollection

Parametreler

pathToMatch

String

Eşleşecek sayfanın yolu.

usernameToMatch

String

Sayfayla ilişkilendirilmiş kişiselleştirme verilerine sahip 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ıtlar.

Döndürülenler

PersonalizationStateInfoCollection

PersonalizationStateInfoCollection Kullanıcı başına kişiselleştirme durumu bilgilerini içeren bir.

Özel durumlar

ArgumentException

pathToMatch veya usernameToMatch 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ı.

Örnekler

Aşağıdaki kod örneği, yönteminin FindUserState nasıl kullanılacağını gösterir. 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şkili 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 işareti (*), 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 kullanabilirsiniz. Ö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 dizesinde 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 ve 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üllere izin vermediğinden parametresi virgül (,) içerebilir.

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.

• WebPartPersonalization
• Web Bölümleri Denetimlerini ASP.NET
• Web Bölümlerini Kişiselleştirmeye Genel Bakış
• İzlenecek yol: Kullanıcı Denetimi ile Web Bölümleri Kişiselleştirmesi Uygulama
• Web Bölümlerini Kişiselleştirme