PersonalizationAdministration 클래스

참조

정의

네임스페이스:: System.Web.UI.WebControls.WebParts

어셈블리:: System.Web.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

웹 파트 개인 설정에 대한 관리 기능을 구현합니다. 이 클래스는 상속될 수 없습니다.

public ref class PersonalizationAdministration abstract sealed

public static class PersonalizationAdministration

type PersonalizationAdministration = class

Public Class PersonalizationAdministration

상속: Object
PersonalizationAdministration

예제

다음 코드 예제에서는 사용 하는 방법에 설명 합니다 여러 메서드를 PersonalizationAdministration 클래스입니다. 이 예제는 라는 Persadmin.ascx웹 파트 사용자 컨트롤을 참조하는 .aspx 페이지로 구성됩니다. 다음 코드는 예제에 대한 .aspx 파일을 제공합니다.

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

이 코드는 컨트롤을 Persadmin.ascx 제공합니다.

중요

이 예제에는 사용자 입력을 허용하는 텍스트 상자가 있으므로 보안상 위험할 수 있습니다. 기본적으로 ASP.NET 웹 페이지는 사용자 입력 내용에 스크립트 또는 HTML 요소가 포함되어 있지 않은지 확인합니다. 자세한 내용은 Script Exploits Overview를 참조하세요.

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

설명

이 클래스는 웹 파트 개인 설정에 대한 관리 및 관리 기능을 노출하는 몇 가지 정적 메서드 및 속성을 제공합니다. 이러한 메서드는 웹 파트 컨트롤에 대한 컨트롤에 WebPartManager 구성된 기본 개인 설정 공급자에 적용됩니다. 개인 설정 공급자 역할을 하는 여러 데이터 저장소를 관리해야 하는 경우 개별 개인 설정 공급자 클래스의 메서드를 직접 사용해야 합니다. 컨트롤에 대해 WebPartManager 구성된 개인 설정 공급자의 컬렉션은 정적 속성에서 Providers 사용할 수 있습니다.

웹 애플리케이션 실행 되지 않는 경우 기본 신뢰 수준의 개인 설정 실패는 알아야 할 중요 한 것 Medium 이상 (사용자 지정 신뢰 수준을 사용 하 여 Web.config 파일에서 설정할 수는 <trust level="" /> 요소). PersonalizationAdministration 및 SqlPersonalizationProvider 클래스는 둘 다 초기화될 때 의 Low 신뢰 수준을 확인합니다. 수준의 트러스트에서 실행 되도록 애플리케이션을 구성 하는 경우 Low, 기본값을 사용 하 고 SqlPersonalizationProvider 애플리케이션에 대 한 개인 설정 데이터를 관리 하는 공급자를 처음으로 애플리케이션에서 개인 설정 데이터에 액세스 하려고 하는 것 실패할 ASP.NET 작업자 프로세스에서 실행 중인 Low 트러스트의 다양 한 클래스를 호출 하는 데 필요한 권한이 없는 System.Data.SqlClient 네임 스페이스입니다.

속성

ApplicationName	공급자가 지정한 애플리케이션의 이름을 가져오거나 설정합니다.
Provider	기본 개인 설정 공급자의 인스턴스를 반환합니다.
Providers	이름을 기준으로 인덱싱된 개인 설정 공급자의 컬렉션을 반환합니다.

메서드

FindInactiveUserState(String, String, DateTime)	지정된 매개 변수를 기반으로 비활성 사용자에 대한 사용자별 개인 설정 상태 정보의 컬렉션을 반환합니다.
FindInactiveUserState(String, String, DateTime, Int32, Int32, Int32)	지정된 매개 변수를 기반으로 비활성 사용자에 대한 사용자별 개인 설정 상태 정보의 컬렉션을 반환합니다.
FindSharedState(String)	지정된 경로를 기반으로 공유되는 개인 설정 상태 정보의 컬렉션을 반환합니다.
FindSharedState(String, Int32, Int32, Int32)	지정된 매개 변수를 기반으로 공유되는 개인 설정 상태 정보의 컬렉션을 반환합니다.
FindUserState(String, String)	사용자 이름과 페이지 경로를 기반으로 사용자별 개인 설정 상태 정보의 컬렉션을 반환합니다.
FindUserState(String, String, Int32, Int32, Int32)	지정된 매개 변수를 기반으로 사용자별 개인 설정 상태 정보의 컬렉션을 반환합니다.
GetAllInactiveUserState(DateTime)	지정된 날짜를 기반으로 비활성 사용자에 관련된 모든 사용자별 개인 설정 상태 정보의 컬렉션을 반환합니다.
GetAllInactiveUserState(DateTime, Int32, Int32, Int32)	지정된 매개 변수를 기반으로 비활성 사용자에 관련된 모든 사용자별 개인 설정 상태 정보의 하위 집합을 반환합니다.
GetAllState(PersonalizationScope)	요청된 개인 설정 범위에 대해 내부 데이터 저장소에서 모든 개인 설정 상태 정보의 컬렉션을 반환합니다.
GetAllState(PersonalizationScope, Int32, Int32, Int32)	지정된 매개 변수를 기반으로 내부 데이터 저장소에서 모든 개인 설정 상태 정보의 하위 집합을 반환합니다.
GetCountOfInactiveUserState(DateTime)	지정된 매개 변수를 기반으로 비활성 사용자에 대한 내부 데이터 저장소의 사용자별 개인 설정 항목 수를 반환합니다.
GetCountOfInactiveUserState(String, DateTime)	지정된 매개 변수를 기반으로 비활성 사용자에 대한 내부 데이터 저장소의 사용자별 개인 설정 항목 수를 반환합니다.
GetCountOfState(PersonalizationScope)	지정된 범위에 대해 내부 데이터 저장소에 있는 개인 설정 상태 항목의 수를 반환합니다.
GetCountOfState(PersonalizationScope, String)	지정된 매개 변수에 대해 내부 데이터 저장소에 있는 개인 설정 상태 항목의 수를 반환합니다.
GetCountOfUserState(String)	지정된 사용자에 대해 내부 데이터 저장소에 있는 개인 설정 상태 항목의 수를 반환합니다.
ResetAllState(PersonalizationScope)	지정된 범위에 관련된 모든 행을 삭제하여 내부 데이터 저장소의 모든 개인 설정 데이터를 다시 설정합니다.
ResetInactiveUserState(DateTime)	지정된 매개 변수를 기반으로 내부 데이터 저장소에서 모든 사용자별 개인 설정 상태 정보를 다시 설정합니다.
ResetInactiveUserState(String, DateTime)	지정된 매개 변수를 기반으로 내부 데이터 저장소에서 비활성 사용자에 대한 모든 사용자별 상태 정보를 다시 설정합니다.
ResetSharedState(String)	내부 데이터 저장소에서 지정된 경로에 대한 공유된 상태를 다시 설정합니다.
ResetSharedState(String[])	내부 데이터 저장소에서 지정된 경로에 대한 공유된 상태를 다시 설정합니다.
ResetState(PersonalizationStateInfoCollection)	컬렉션에 포함된 항목에 따라 기본 데이터 저장소의 개인 설정 데이터를 다시 설정합니다.
ResetUserState(String)	내부 데이터 저장소에서 지정된 경로에 대한 모든 사용자별 상태를 다시 설정합니다.
ResetUserState(String, String)	내부 데이터 저장소에서 사용자 이름과 경로의 지정된 조합에 대한 사용자별 상태를 다시 설정합니다.
ResetUserState(String, String[])	내부 데이터 저장소에서 지정된 페이지와 사용자에 대한 사용자별 상태를 다시 설정합니다.
ResetUserState(String[])	내부 데이터 저장소에서 지정된 경로에 대한 모든 사용자별 상태를 다시 설정합니다.

적용 대상

PersonalizationAdministration 클래스

정의

예제

설명

속성

메서드

적용 대상

추가 정보

피드백

추가 리소스