PersonalizationAdministration Sınıf

Başvuru

Tanım

Ad Alanı:: System.Web.UI.WebControls.WebParts

Bütünleştirilmiş Kod:: System.Web.dll

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

Web Bölümlerini kişiselleştirme için yönetim ve yönetim işlevlerini uygular. Bu sınıf devralınamaz.

public ref class PersonalizationAdministration abstract sealed

public static class PersonalizationAdministration

type PersonalizationAdministration = class

Public Class PersonalizationAdministration

Devralma: Object
PersonalizationAdministration

Örnekler

Aşağıdaki kod örneği, sınıfında çeşitli yöntemlerin PersonalizationAdministration nasıl kullanılacağını gösterir. Bu örnek, adlı Persadmin.ascxWeb Bölümleri kullanıcı denetimine başvuran bir .aspx sayfasından oluşur. Aşağıdaki kod, örnek için .aspx dosyasını sağlar.

<%@ Page Language="C#" %>
<%@ Register TagPrefix="admin" TagName="administrator" Src="~/PersAdmin.ascx" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
       <div>
        &nbsp;<asp:LoginName ID="LoginName1" runat="server" />
        &nbsp;
        <asp:LoginStatus ID="LoginStatus1" runat="server" LogoutAction="RedirectToLoginPage" />
        &nbsp;&nbsp;&nbsp;&nbsp;<br />
        <br />
        </div>
        <asp:WebPartManager ID="WebPartManager1" runat="server"></asp:WebPartManager>
        <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
        <admin:administrator id="admincontrol" runat="server" />
        </ZoneTemplate>
        </asp:WebPartZone>
    </form>
</body>
</html>

Bu kod denetimi sağlar Persadmin.ascx .

Ö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ış.

<%@ Control Language="C#" ClassName="PersAdmin" %>

<script runat="server">
    WebPartManager _manager;
    string _provider;
    string _userscope;

  void Page_Init(object sender, EventArgs e)
  {
    Page.InitComplete += new EventHandler(InitComplete);
  }

    void InitComplete(object sender, System.EventArgs e)
    {
        _manager = WebPartManager.GetCurrentWebPartManager(Page);
        // <snippet4>
        _provider = PersonalizationAdministration.Provider.Name;
        TextBox1.Text = _provider;
        // </snippet4>
        // <snippet6>
        if (_manager.Personalization.Scope == PersonalizationScope.Shared)
        {
            TextBox2.Text = "Shared Scope";
        }
        else
            TextBox2.Text = "User Scope";
        // </snippet6>
           // <snippet5>
        Label4.Visible = false;
        TextBox4.Text = PersonalizationAdministration.GetCountOfState(PersonalizationScope.User).ToString();
            // </snippet5>
    }

// <snippet2>
    protected void Button1_Click(object sender, EventArgs e)
    {
        if (TextBox3.Text != null)
        {
            // <snippet3>
            PersonalizationStateInfoCollection findresult;
          findresult = PersonalizationAdministration.FindUserState(null, TextBox3.Text);
          if (findresult.Count != 0)
          {
              Label4.Text = findresult.Count + "  user(s) found";
              Label4.Visible = true;
          }
              // </snippet3>
          else
          {
              Label4.Text = "No users found.";
              Label4.Visible = true;
          }
        }
      else
      {
          Label4.Text = "You must enter a user name to find.";
      }

    }
    // </snippet2>

</script>
<asp:Label ID="Label1" runat="server" Text="Personalization Provider" Width="162px"
  AssociatedControlID="TextBox1" />
<br />
<asp:TextBox ID="TextBox1" runat="server" Width="268px"></asp:TextBox>
<br />
<br />
<asp:Label ID="Label2" runat="server" Text="Scope" AssociatedControlID="TextBox2" />
<br />
<asp:TextBox ID="TextBox2" runat="server" Width="90px"></asp:TextBox>
<br />
<br />
<asp:Label ID="Label3" runat="server" Text="User to Find" Width="135px"
  AssociatedControlID="TextBox3" />
<br />
<asp:TextBox ID="TextBox3" runat="server"></asp:TextBox>
&nbsp;
<asp:Label ID="Label4" runat="server" Width="77px" ForeColor="Red" />
<br />
<br />
<asp:Button ID="Button1" runat="server" Text="Find User" OnClick="Button1_Click" />&nbsp;&nbsp;&nbsp;
<br />
<br />
<asp:Label ID="Label5" runat="server" Text="Personalization Statistics" Width="204px" />
<br />
<br />
<asp:Label ID="Label6" runat="server" Text="Number of User Personalization States" Width="246px"
  AssociatedControlID="TextBox4" Height="21px" />
<br />
<asp:TextBox ID="TextBox4" runat="server" Width="63px"></asp:TextBox>
<br />
<br />
<br />
<br />

Açıklamalar

Bu sınıf, Web Bölümleri kişiselleştirmesi için yönetim ve yönetim işlevlerini kullanıma sunan birkaç statik yöntem ve özellik sağlar. Bu yöntemler, Web Bölümleri denetimi denetiminde WebPartManager yapılandırılan varsayılan kişiselleştirme sağlayıcısı için geçerlidir. Kişiselleştirme sağlayıcıları olarak davranan çeşitli veri depolarını yönetmeniz gerekiyorsa, yöntemleri doğrudan bireysel kişiselleştirme sağlayıcısı sınıflarında kullanmanız gerekir. Bir denetim için WebPartManager yapılandırılmış kişiselleştirme sağlayıcıları koleksiyonunun statik özelliğinden Providers kullanılabildiğini unutmayın.

Web uygulamanız varsayılan güven düzeyinde veya daha yüksek bir düzeyde çalışmazsa kişiselleştirmenin Medium başarısız olacağını bilmeniz önemlidir (öğesini kullanarak <trust level="" /> Web.config bir dosyada özel güven düzeyleri ayarlayabilirsiniz). PersonalizationAdministration ve SqlPersonalizationProvider sınıflarının her ikisi de başlatıldığında güven düzeyini Low denetler. Uygulamanızı güven düzeyinde Lowçalışacak şekilde yapılandırırsanız ve uygulamanızın kişiselleştirme verilerini yönetmek için varsayılan SqlPersonalizationProvider sağlayıcıyı kullanırsanız, uygulama kişiselleştirme verilerine ilk kez erişmeye çalıştığında, güven içinde Low çalışan bir ASP.NET çalışan işlemi ad alanında çeşitli sınıflara System.Data.SqlClient çağrı yapmak için gerekli izinlere sahip olmadığından başarısız olur.

Özellikler

ApplicationName	Sağlayıcı tarafından belirtilen uygulamanın adını alır veya ayarlar.
Provider	Varsayılan kişiselleştirme sağlayıcısının bir örneğini döndürür.
Providers	Ada göre dizinlenmiş bir kişiselleştirme sağlayıcıları koleksiyonu döndürür.

Yöntemler

FindInactiveUserState(String, String, DateTime)	Belirtilen parametrelere bağlı olarak etkin olmayan kullanıcılar için kullanıcı başına kişiselleştirme durumu bilgilerini içeren bir koleksiyon döndürür.
FindInactiveUserState(String, String, DateTime, Int32, Int32, Int32)	Belirtilen parametrelere bağlı olarak etkin olmayan kullanıcılar için kullanıcı başına kişiselleştirme durumu bilgilerini içeren bir koleksiyon döndürür.
FindSharedState(String)	Belirtilen yola göre paylaşılan kişiselleştirme durumu bilgilerinden oluşan 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.
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.
GetAllInactiveUserState(DateTime)	Belirtilen tarihe göre etkin olmayan kullanıcılarla ilişkili tüm kullanıcı başına kişiselleştirme durumu bilgilerini içeren bir koleksiyon döndürür.
GetAllInactiveUserState(DateTime, Int32, Int32, Int32)	Belirtilen parametrelere göre etkin olmayan kullanıcılarla ilişkili tüm kullanıcı başına kişiselleştirme durumu bilgilerinin bir alt kümesini döndürür.
GetAllState(PersonalizationScope)	İstenen kişiselleştirme kapsamı için temel alınan veri deposundan tüm kişiselleştirme durumu bilgilerinin bir koleksiyonunu döndürür.
GetAllState(PersonalizationScope, Int32, Int32, Int32)	Belirtilen parametrelere göre temel alınan veri deposundaki tüm kişiselleştirme durumu bilgilerinin bir alt kümesini döndürür.
GetCountOfInactiveUserState(DateTime)	Belirtilen parametreye göre etkin olmayan kullanıcılar için temel alınan veri deposundaki kullanıcı başına kişiselleştirme öğelerinin sayısını döndürür.
GetCountOfInactiveUserState(String, DateTime)	Belirtilen parametrelere göre etkin olmayan kullanıcılar için temel alınan veri deposundaki kullanıcı başına kişiselleştirme öğelerinin sayısını döndürür.
GetCountOfState(PersonalizationScope)	Belirtilen kapsam için var olan temel veri deposundaki kişiselleştirme durumu öğelerinin sayısını döndürür.
GetCountOfState(PersonalizationScope, String)	Belirtilen parametreler için var olan temel veri deposundaki kişiselleştirme durumu öğelerinin sayısını döndürür.
GetCountOfUserState(String)	Belirtilen kullanıcı için var olan temel veri deposundaki kişiselleştirme durumu öğelerinin sayısını döndürür.
ResetAllState(PersonalizationScope)	Belirtilen kapsamla ilişkili tüm satırları silerek temel alınan veri deposundaki tüm kişiselleştirme verilerini sıfırlar.
ResetInactiveUserState(DateTime)	Belirtilen parametreye göre, temel alınan veri deposundaki tüm kullanıcı başına kişiselleştirme durumu bilgilerini sıfırlar.
ResetInactiveUserState(String, DateTime)	Belirtilen parametrelere göre etkin olmayan kullanıcılar için temel alınan veri deposundaki tüm kullanıcı başına durum bilgilerini sıfırlar.
ResetSharedState(String)	Belirtilen yol için temel alınan veri deposundaki paylaşılan durumu sıfırlar.
ResetSharedState(String[])	Belirtilen yollar için temel alınan veri deposundaki paylaşılan durumu sıfırlar.
ResetState(PersonalizationStateInfoCollection)	Koleksiyondaki öğelere göre temel alınan veri deposundaki kişiselleştirme verilerini sıfırlar.
ResetUserState(String)	Belirtilen yol için temel alınan veri deposundaki tüm kullanıcı başına durumu sıfırlar.
ResetUserState(String, String)	Belirtilen kullanıcı adı ve yol bileşimi için temel alınan veri deposundaki kullanıcı başına durumu sıfırlar.
ResetUserState(String, String[])	Sayfa ve belirtilen kullanıcılar için temel alınan veri deposundaki kullanıcı başına durumu sıfırlar.
ResetUserState(String[])	Belirtilen yollar için temel alınan veri deposundaki tüm kullanıcı başına durumu sıfırlar.

Şunlara uygulanır

Aracılığıyla paylaş