PersonalizationAdministration Classe

Definizione

Implementa funzionalità di gestione e amministrazione per la personalizzazione di Web part.Implements management and administrative functionality for Web Parts personalization. Questa classe non può essere ereditata.This class cannot be inherited.

public ref class PersonalizationAdministration abstract sealed
public static class PersonalizationAdministration
type PersonalizationAdministration = class
Public Class PersonalizationAdministration
Ereditarietà
PersonalizationAdministration

Esempi

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare diversi PersonalizationAdministration metodi nella classe.The following code example demonstrates how to use several methods in the PersonalizationAdministration class. Questo esempio è costituito da una pagina aspx che fa riferimento a un Web part Persadmin.ascxcontrollo utente denominato.This example consists of an .aspx page that references a Web Parts user control named Persadmin.ascx. Il codice seguente fornisce il file aspx per l'esempio.The following code provides the .aspx file for the example.

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

Questo codice fornisce il Persadmin.ascx controllo.This code provides the Persadmin.ascx control.

Importante

L'esempio include una casella di testo che accetta l'input dell'utente e rappresenta quindi una potenziale minaccia alla sicurezza.This example has a text box that accepts user input, which is a potential security threat. Per impostazione predefinita, le pagine Web ASP.NET verificano che l'input dell'utente non includa script o elementi HTML.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Per altre informazioni, vedere Cenni preliminari sugli attacchi tramite script.For more information, see 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 />

Commenti

Questa classe fornisce diversi metodi e proprietà statici che espongono le funzionalità di gestione e amministrative per la personalizzazione del Web part.This class provides several static methods and properties that expose management and administrative functionality for Web Parts personalization. Questi metodi si applicano al provider di personalizzazioni predefinito WebPartManager configurato nel controllo per un controllo Web part.These methods apply to the default personalization provider configured in the WebPartManager control for a Web Parts control. Se è necessario amministrare diversi archivi dati che fungono da provider di personalizzazioni, è consigliabile utilizzare direttamente i metodi delle singole classi del provider di personalizzazione.If you need to administer several data stores that are acting as personalization providers, you should use the methods on the individual personalization provider classes directly. Si noti che la raccolta di provider di personalizzazioni WebPartManager configurati per un Providers controllo è disponibile dalla proprietà statica.Note that the collection of configured personalization providers for a WebPartManager control is available from the Providers static property.

È importante tenere presente che la personalizzazione avrà esito negativo se l'applicazione Web non viene eseguita al livello di Medium attendibilità predefinito o superiore. è possibile impostare livelli di attendibilità personalizzati in un file Web. config utilizzando l' <trust level="" /> elemento.It is important to be aware that personalization will fail if your Web application does not run at the default trust level of Medium or higher (you can set custom trust levels in a Web.config file using the <trust level="" /> element). Entrambe PersonalizationAdministration le SqlPersonalizationProvider classi e verificano la presenza di un Low livello di attendibilità di quando vengono inizializzate.The PersonalizationAdministration and SqlPersonalizationProvider classes both check for a trust level of Low when they are initialized. Se si configura l'applicazione per l'esecuzione a un livello di Lowattendibilità di e si utilizza SqlPersonalizationProvider il provider predefinito per gestire i dati di personalizzazione per l'applicazione, la prima volta che l'applicazione tenta di accedere ai dati di personalizzazione, verrà ha esito negativo perché un processo di Low lavoro di ASP.NET in esecuzione in attendibilità non dispone delle autorizzazioni necessarie per chiamare System.Data.SqlClient le varie classi nello spazio dei nomi.If you configure your application to run at a trust level of Low, and you use the default SqlPersonalizationProvider provider to manage the personalization data for your application, the first time that the application tries to access personalization data, it will fail because an ASP.NET worker process running in Low trust does not have the permissions necessary to call into the various classes in the System.Data.SqlClient namespace.

Proprietà

ApplicationName

Ottiene o imposta il nome dell'applicazione specificata dal provider.Gets or sets the name of the application specified by the provider.

Provider

Restituisce un'istanza del provider di personalizzazioni predefinito.Returns an instance of the default personalization provider.

Providers

Restituisce un insieme di provider di personalizzazioni indicizzati in base al nome.Returns a collection of personalization providers indexed by name.

Metodi

FindInactiveUserState(String, String, DateTime)

Restituisce un insieme di informazioni di stato sulla personalizzazione per singolo utente relativo agli utenti inattivi in base ai parametri specificati.Returns a collection of per-user personalization state information for inactive users, based on the specified parameters.

FindInactiveUserState(String, String, DateTime, Int32, Int32, Int32)

Restituisce un insieme di informazioni di stato sulla personalizzazione per singolo utente relativo agli utenti inattivi in base ai parametri specificati.Returns a collection of per-user personalization state information for inactive users, based on the specified parameters.

FindSharedState(String)

Restituisce un insieme di informazioni condivise sullo stato di personalizzazione in base al percorso specificato.Returns a collection of shared personalization state information based on the specified path.

FindSharedState(String, Int32, Int32, Int32)

Restituisce un insieme di informazioni condivise sullo stato di personalizzazione in base ai parametri specificati.Returns a collection of shared personalization state information based on the specified parameters.

FindUserState(String, String)

Restituisce un insieme di informazioni di stato sulla personalizzazione per singolo utente in base al nome utente e al percorso della pagina.Returns a collection of per-user personalization state information based on the user name and page path.

FindUserState(String, String, Int32, Int32, Int32)

Restituisce un insieme di informazioni di stato sulla personalizzazione per singolo utente in base ai parametri specificati.Returns a collection of per-user personalization state information based on the specified parameters.

GetAllInactiveUserState(DateTime)

Restituisce un insieme di tutte le informazioni di stato sulla personalizzazione per singolo utente associate agli utenti inattivi in base alla data specificata.Returns a collection of all per-user personalization state information associated with inactive users, based on the specified date.

GetAllInactiveUserState(DateTime, Int32, Int32, Int32)

Restituisce un sottoinsieme di tutte le informazioni di stato sulla personalizzazione per singolo utente associate agli utenti inattivi in base ai parametri specificati.Returns a subset of all per-user personalization state information associated with inactive users, based on the specified parameters.

GetAllState(PersonalizationScope)

Restituisce un insieme di tutte le informazioni di stato sulla personalizzazione dell'archivio dati sottostante per l'ambito di personalizzazione richiesto.Returns a collection of all personalization state information from the underlying data store for the requested personalization scope.

GetAllState(PersonalizationScope, Int32, Int32, Int32)

Restituisce un sottoinsieme di tutte le informazioni di stato sulla personalizzazione dall'archivio dati sottostante in base ai parametri specificati.Returns a subset of all personalization state information from the underlying data store, based on the specified parameters.

GetCountOfInactiveUserState(DateTime)

Restituisce il numero degli elementi di personalizzazione per singolo utente inclusi nell'archivio dati sottostante per gli utenti inattivi in base al parametro specificato.Returns a count of the per-user personalization items in the underlying data store for inactive users, based on the parameter specified.

GetCountOfInactiveUserState(String, DateTime)

Restituisce il numero degli elementi di personalizzazione per singolo utente inclusi nell'archivio dati sottostante per gli utenti inattivi in base ai parametri specificati.Returns a count of the per-user personalization items in the underlying data store for inactive users, based on the specified parameters.

GetCountOfState(PersonalizationScope)

Restituisce il numero degli elementi relativi allo stato di personalizzazione disponibili nell'archivio dati sottostante per l'ambito specificato.Returns a count of the personalization state items in the underlying data store that exist for the specified scope.

GetCountOfState(PersonalizationScope, String)

Restituisce il numero degli elementi relativi allo stato di personalizzazione disponibili nell'archivio dati sottostante per i parametri specificati.Returns a count of the personalization state items in the underlying data store that exist for the specified parameters.

GetCountOfUserState(String)

Restituisce il numero degli elementi relativi allo stato di personalizzazione disponibili nell'archivio dati sottostante per l'utente specificato.Returns a count of the personalization state items in the underlying data store that exist for the specified user.

ResetAllState(PersonalizationScope)

Reimposta tutti i dati sulla personalizzazione disponibili nell'archivio dati sottostante eliminando tutte le righe associate all'ambito specificato.Resets all personalization data in the underlying data store by deleting all rows associated with the specified scope.

ResetInactiveUserState(DateTime)

Reimposta tutte le informazioni di stato sulla personalizzazione per singolo utente disponibili nell'archivio dati sottostante in base al parametro specificato.Resets all per-user personalization state information in the underlying data store, based on the specified parameter.

ResetInactiveUserState(String, DateTime)

Reimposta tutte le informazioni sullo stato per singolo utente disponibili nell'archivio dati sottostante per gli utenti inattivi in base ai parametri specificati.Resets all per-user state information in the underlying data store for inactive users, based on the specified parameters.

ResetSharedState(String)

Reimposta lo stato condiviso nell'archivio dati sottostante per il percorso specificato.Resets shared state in the underlying data store for the specified path.

ResetSharedState(String[])

Reimposta lo stato condiviso nell'archivio dati sottostante per i percorsi specificati.Resets shared state in the underlying data store for the specified paths.

ResetState(PersonalizationStateInfoCollection)

Reimposta i dati di personalizzazione nell'archivio dati sottostante, in base agli elementi contenuti nella raccolta.Resets personalization data in the underlying data store, based on the items contained in the collection.

ResetUserState(String)

Reimposta tutti gli stati per singolo utente nell'archivio dati sottostante per il percorso specificato.Resets all per-user state in the underlying data store for the specified path.

ResetUserState(String, String)

Reimposta lo stato per singolo utente nell'archivio dati sottostante per la combinazione di nome utente e percorso specificata.Resets per-user state in the underlying data store for the specified combination of user name and path.

ResetUserState(String, String[])

Reimposta lo stato per singolo utente nell'archivio dati sottostante per la pagina e gli utenti specificati.Resets per-user state in the underlying data store for the page and users specified.

ResetUserState(String[])

Reimposta tutti gli stati per singolo utente nell'archivio dati sottostante per i percorsi specificati.Resets all per-user state in the underlying data store for the specified paths.

Si applica a

Vedi anche