PersonalizationAdministration Kelas

Referensi

Definisi

Ruang nama:: System.Web.UI.WebControls.WebParts

Rakitan:: System.Web.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menerapkan fungsionalitas manajemen dan administratif untuk personalisasi Bagian Web. Kelas ini tidak dapat diwariskan.

public ref class PersonalizationAdministration abstract sealed

public static class PersonalizationAdministration

type PersonalizationAdministration = class

Public Class PersonalizationAdministration

Warisan: Object
PersonalizationAdministration

Contoh

Contoh kode berikut menunjukkan cara menggunakan beberapa metode di PersonalizationAdministration kelas . Contoh ini terdiri dari halaman .aspx yang mereferensikan kontrol pengguna Bagian Web bernama Persadmin.ascx. Kode berikut menyediakan file .aspx untuk contoh.

<%@ 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>

Kode ini menyediakan Persadmin.ascx kontrol.

Penting

Contoh ini memiliki kotak teks yang menerima input pengguna, yang merupakan potensi ancaman keamanan. Secara default, ASP.NET halaman Web memvalidasi bahwa input pengguna tidak menyertakan elemen skrip atau HTML. Untuk informasi selengkapnya, lihat Gambaran Umum Eksploitasi Skrip.

<%@ 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 />

Keterangan

Kelas ini menyediakan beberapa metode statis dan properti yang mengekspos manajemen dan fungsionalitas administratif untuk personalisasi Bagian Web. Metode ini berlaku untuk penyedia personalisasi default yang dikonfigurasi dalam WebPartManager kontrol untuk kontrol Bagian Web. Jika Anda perlu mengelola beberapa penyimpanan data yang bertindak sebagai penyedia personalisasi, Anda harus menggunakan metode pada kelas penyedia personalisasi individual secara langsung. Perhatikan bahwa kumpulan penyedia personalisasi yang WebPartManager dikonfigurasi untuk kontrol tersedia dari Providers properti statis.

Penting untuk diketahui bahwa personalisasi akan gagal jika aplikasi Web Anda tidak berjalan pada tingkat Medium kepercayaan default atau lebih tinggi (Anda dapat mengatur tingkat kepercayaan kustom dalam file Web.config menggunakan <trust level="" /> elemen ). Kelas PersonalizationAdministration dan SqlPersonalizationProvider keduanya memeriksa tingkat Low kepercayaan kapan mereka diinisialisasi. Jika Anda mengonfigurasi aplikasi untuk berjalan pada tingkat Lowkepercayaan , dan Anda menggunakan penyedia default SqlPersonalizationProvider untuk mengelola data personalisasi untuk aplikasi Anda, pertama kali aplikasi mencoba mengakses data personalisasi, itu akan gagal karena proses pekerja ASP.NET yang berjalan dengan Low kepercayaan tidak memiliki izin yang diperlukan untuk memanggil ke berbagai kelas di System.Data.SqlClient namespace layanan.

Properti

ApplicationName	Mendapatkan atau menetapkan nama aplikasi yang ditentukan oleh penyedia.
Provider	Mengembalikan instans penyedia personalisasi default.
Providers	Mengembalikan kumpulan penyedia personalisasi yang diindeks berdasarkan nama.

Metode

FindInactiveUserState(String, String, DateTime)	Mengembalikan kumpulan informasi status personalisasi per pengguna untuk pengguna yang tidak aktif, berdasarkan parameter yang ditentukan.
FindInactiveUserState(String, String, DateTime, Int32, Int32, Int32)	Mengembalikan kumpulan informasi status personalisasi per pengguna untuk pengguna yang tidak aktif, berdasarkan parameter yang ditentukan.
FindSharedState(String)	Mengembalikan kumpulan informasi status personalisasi bersama berdasarkan jalur yang ditentukan.
FindSharedState(String, Int32, Int32, Int32)	Mengembalikan kumpulan informasi status personalisasi bersama berdasarkan parameter yang ditentukan.
FindUserState(String, String)	Mengembalikan kumpulan informasi status personalisasi per pengguna berdasarkan nama pengguna dan jalur halaman.
FindUserState(String, String, Int32, Int32, Int32)	Mengembalikan kumpulan informasi status personalisasi per pengguna berdasarkan parameter yang ditentukan.
GetAllInactiveUserState(DateTime)	Mengembalikan kumpulan semua informasi status personalisasi per pengguna yang terkait dengan pengguna yang tidak aktif, berdasarkan tanggal yang ditentukan.
GetAllInactiveUserState(DateTime, Int32, Int32, Int32)	Mengembalikan subset semua informasi status personalisasi per pengguna yang terkait dengan pengguna yang tidak aktif, berdasarkan parameter yang ditentukan.
GetAllState(PersonalizationScope)	Mengembalikan kumpulan semua informasi status personalisasi dari penyimpanan data yang mendasar untuk cakupan personalisasi yang diminta.
GetAllState(PersonalizationScope, Int32, Int32, Int32)	Mengembalikan subset semua informasi status personalisasi dari penyimpanan data yang mendasar, berdasarkan parameter yang ditentukan.
GetCountOfInactiveUserState(DateTime)	Mengembalikan hitungan item personalisasi per pengguna di penyimpanan data yang mendasar untuk pengguna yang tidak aktif, berdasarkan parameter yang ditentukan.
GetCountOfInactiveUserState(String, DateTime)	Mengembalikan hitungan item personalisasi per pengguna di penyimpanan data yang mendasar untuk pengguna yang tidak aktif, berdasarkan parameter yang ditentukan.
GetCountOfState(PersonalizationScope)	Mengembalikan hitungan item status personalisasi di penyimpanan data dasar yang ada untuk cakupan yang ditentukan.
GetCountOfState(PersonalizationScope, String)	Mengembalikan hitungan item status personalisasi di penyimpanan data dasar yang ada untuk parameter yang ditentukan.
GetCountOfUserState(String)	Mengembalikan hitungan item status personalisasi di penyimpanan data dasar yang ada untuk pengguna yang ditentukan.
ResetAllState(PersonalizationScope)	Mereset semua data personalisasi di penyimpanan data yang mendasar dengan menghapus semua baris yang terkait dengan cakupan yang ditentukan.
ResetInactiveUserState(DateTime)	Mengatur ulang semua informasi status personalisasi per pengguna di penyimpanan data yang mendasar, berdasarkan parameter yang ditentukan.
ResetInactiveUserState(String, DateTime)	Mengatur ulang semua informasi status per pengguna di penyimpanan data yang mendasar untuk pengguna yang tidak aktif, berdasarkan parameter yang ditentukan.
ResetSharedState(String)	Mereset status bersama di penyimpanan data yang mendasar untuk jalur yang ditentukan.
ResetSharedState(String[])	Mereset status bersama di penyimpanan data yang mendasar untuk jalur yang ditentukan.
ResetState(PersonalizationStateInfoCollection)	Mereset data personalisasi di penyimpanan data yang mendasar, berdasarkan item yang terkandung dalam koleksi.
ResetUserState(String)	Mereset semua status per pengguna di penyimpanan data yang mendasar untuk jalur yang ditentukan.
ResetUserState(String, String)	Mereset status per pengguna di penyimpanan data yang mendasar untuk kombinasi nama dan jalur pengguna yang ditentukan.
ResetUserState(String, String[])	Mereset status per pengguna di penyimpanan data yang mendasar untuk halaman dan pengguna yang ditentukan.
ResetUserState(String[])	Mereset semua status per pengguna di penyimpanan data yang mendasar untuk jalur yang ditentukan.

Berlaku untuk

Bagikan melalui