PersonalizationAdministration Classe

Definição

Namespace:: System.Web.UI.WebControls.WebParts

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Implementa o gerenciamento e a funcionalidade administrativa para personalização de Web Parts. Essa classe não pode ser herdada.

public ref class PersonalizationAdministration abstract sealed

public static class PersonalizationAdministration

type PersonalizationAdministration = class

Public Class PersonalizationAdministration

Herança: Object
PersonalizationAdministration

Exemplos

O exemplo de código a seguir demonstra como usar vários métodos na PersonalizationAdministration classe. Este exemplo consiste em uma página .aspx que faz referência a um controle de usuário de Web Parts chamado Persadmin.ascx. O código a seguir fornece o arquivo .aspx para o exemplo.

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

Esse código fornece o Persadmin.ascx controle.

Importante

Este exemplo tem uma caixa de texto que aceita a entrada do usuário, que é uma potencial ameaça à segurança. Por padrão, ASP.NET páginas da Web validam que a entrada do usuário não inclui elementos de script ou HTML. Para obter mais informações, consulte Visão geral das Explorações de Script.

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

Comentários

Essa classe fornece vários métodos estáticos e propriedades que expõem o gerenciamento e a funcionalidade administrativa para personalização de Web Parts. Esses métodos se aplicam ao provedor de personalização padrão configurado no WebPartManager controle de um controle de Web Parts. Se você precisar administrar vários repositórios de dados que atuam como provedores de personalização, use os métodos nas classes de provedor de personalização individuais diretamente. Observe que a coleção de provedores de personalização configurados para um WebPartManager controle está disponível na Providers propriedade estática.

É importante estar ciente de que a personalização falhará se seu aplicativo Web não for executado no nível de confiança padrão ou Medium superior (você pode definir níveis de confiança personalizados em um arquivo Web.config usando o <trust level="" /> elemento). As PersonalizationAdministration classes e SqlPersonalizationProvider as classes verificam um nível de confiança de Low quando são inicializadas. Se você configurar seu aplicativo para ser executado em um nível de confiança de Low, e você usa o provedor SqlPersonalizationProvider padrão para gerenciar os dados de personalização do seu aplicativo, na primeira vez que o aplicativo tenta acessar dados de personalização, ele falhará porque um processo de trabalho ASP.NET em execução no Low trust não tem as permissões necessárias para chamar as várias classes no namespace System.Data.SqlClient.

Propriedades

Nome	Description
ApplicationName	Obtém ou define o nome do aplicativo especificado pelo provedor.
Provider	Retorna uma instância do provedor de personalização padrão.
Providers	Retorna uma coleção de provedores de personalização indexados pelo nome.

Métodos

Nome	Description
FindInactiveUserState(String, String, DateTime, Int32, Int32, Int32)	Retorna uma coleção de informações de estado de personalização por usuário para usuários inativos, com base nos parâmetros especificados.
FindInactiveUserState(String, String, DateTime)	Retorna uma coleção de informações de estado de personalização por usuário para usuários inativos, com base nos parâmetros especificados.
FindSharedState(String, Int32, Int32, Int32)	Retorna uma coleção de informações de estado de personalização compartilhada com base nos parâmetros especificados.
FindSharedState(String)	Retorna uma coleção de informações de estado de personalização compartilhadas com base no caminho especificado.
FindUserState(String, String, Int32, Int32, Int32)	Retorna uma coleção de informações de estado de personalização por usuário com base nos parâmetros especificados.
FindUserState(String, String)	Retorna uma coleção de informações de estado de personalização por usuário com base no nome de usuário e no caminho da página.
GetAllInactiveUserState(DateTime, Int32, Int32, Int32)	Retorna um subconjunto de todas as informações de estado de personalização por usuário associadas a usuários inativos, com base nos parâmetros especificados.
GetAllInactiveUserState(DateTime)	Retorna uma coleção de todas as informações de estado de personalização por usuário associadas a usuários inativos, com base na data especificada.
GetAllState(PersonalizationScope, Int32, Int32, Int32)	Retorna um subconjunto de todas as informações de estado de personalização do armazenamento de dados subjacente, com base nos parâmetros especificados.
GetAllState(PersonalizationScope)	Retorna uma coleção de todas as informações de estado de personalização do armazenamento de dados subjacente para o escopo de personalização solicitado.
GetCountOfInactiveUserState(DateTime)	Retorna uma contagem dos itens de personalização por usuário no armazenamento de dados subjacente para usuários inativos, com base no parâmetro especificado.
GetCountOfInactiveUserState(String, DateTime)	Retorna uma contagem dos itens de personalização por usuário no armazenamento de dados subjacente para usuários inativos, com base nos parâmetros especificados.
GetCountOfState(PersonalizationScope, String)	Retorna uma contagem dos itens de estado de personalização no armazenamento de dados subjacente que existem para os parâmetros especificados.
GetCountOfState(PersonalizationScope)	Retorna uma contagem dos itens de estado de personalização no armazenamento de dados subjacente que existem para o escopo especificado.
GetCountOfUserState(String)	Retorna uma contagem dos itens de estado de personalização no armazenamento de dados subjacente que existem para o usuário especificado.
ResetAllState(PersonalizationScope)	Redefine todos os dados de personalização no armazenamento de dados subjacente excluindo todas as linhas associadas ao escopo especificado.
ResetInactiveUserState(DateTime)	Redefine todas as informações de estado de personalização por usuário no armazenamento de dados subjacente, com base no parâmetro especificado.
ResetInactiveUserState(String, DateTime)	Redefine todas as informações de estado por usuário no armazenamento de dados subjacente para usuários inativos, com base nos parâmetros especificados.
ResetSharedState(String)	Redefine o estado compartilhado no armazenamento de dados subjacente para o caminho especificado.
ResetSharedState(String[])	Redefine o estado compartilhado no armazenamento de dados subjacente para os caminhos especificados.
ResetState(PersonalizationStateInfoCollection)	Redefine dados de personalização no armazenamento de dados subjacente, com base nos itens contidos na coleção.
ResetUserState(String, String)	Redefine o estado por usuário no armazenamento de dados subjacente para a combinação especificada de nome de usuário e caminho.
ResetUserState(String, String[])	Redefine o estado por usuário no armazenamento de dados subjacente para a página e os usuários especificados.
ResetUserState(String)	Redefine todo o estado por usuário no armazenamento de dados subjacente para o caminho especificado.
ResetUserState(String[])	Redefine todo o estado por usuário no armazenamento de dados subjacente para os caminhos especificados.

Aplica-se a

Confira também

Comentários

Esta página foi útil?