PersonalizationAdministration Klass

Definition

Namnområde:: System.Web.UI.WebControls.WebParts

Sammansättning:: System.Web.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Implementerar hanterings- och administrationsfunktioner för anpassning av webbdelar. Det går inte att ärva den här klassen.

public ref class PersonalizationAdministration abstract sealed

public static class PersonalizationAdministration

type PersonalizationAdministration = class

Public Class PersonalizationAdministration

Arv: Object
PersonalizationAdministration

Exempel

Följande kodexempel visar hur du använder flera metoder i PersonalizationAdministration klassen. Det här exemplet består av en .aspx sida som refererar till en användarkontroll för webbdelar med namnet Persadmin.ascx. Följande kod innehåller den .aspx filen för exemplet.

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

Den här koden tillhandahåller Persadmin.ascx kontrollen.

Important

Det här exemplet har en textruta som accepterar användarindata, vilket är ett potentiellt säkerhetshot. Som standard kontrollerar ASP.NET webbsidor att användarindata inte innehåller skript- eller HTML-element. Mer information finns i Översikt över skriptexploateringar.

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

Kommentarer

Den här klassen innehåller flera statiska metoder och egenskaper som exponerar hanteringsfunktioner och administrativa funktioner för anpassning av webbdelar. Dessa metoder gäller för standardanpassningsprovidern som konfigurerats i WebPartManager kontrollen för en webbdelskontroll. Om du behöver administrera flera datalager som fungerar som personanpassningsproviders bör du använda metoderna på de enskilda personanpassningsproviderklasserna direkt. Observera att samlingen med konfigurerade personanpassningsproviders för en WebPartManager kontroll är tillgänglig från den Providers statiska egenskapen.

Det är viktigt att vara medveten om att anpassningen misslyckas om webbprogrammet inte körs på standardförtroendenivån Medium eller högre (du kan ange anpassade förtroendenivåer i en Web.config fil med elementet <trust level="" /> ). Klasserna PersonalizationAdministration och SqlPersonalizationProvider söker båda efter en förtroendenivå Low för när de initieras. Om du konfigurerar programmet så att det körs på en förtroendenivå på Low, och du använder standardprovidern SqlPersonalizationProvider för att hantera anpassningsdata för ditt program. Första gången programmet försöker komma åt anpassningsdata misslyckas det eftersom en ASP.NET arbetsprocess som körs i Low förtroende inte har de behörigheter som krävs för att anropa till de olika klasserna i System.Data.SqlClient namnrymd.

Egenskaper

Name	Description
ApplicationName	Hämtar eller anger namnet på det program som anges av providern.
Provider	Returnerar en instans av standardprovidern för anpassning.
Providers	Returnerar en samling personanpassningsproviders indexerade efter namn.

Metoder

Name	Description
FindInactiveUserState(String, String, DateTime, Int32, Int32, Int32)	Returnerar en samling personanpassningstillståndsinformation per användare för inaktiva användare baserat på de angivna parametrarna.
FindInactiveUserState(String, String, DateTime)	Returnerar en samling personanpassningstillståndsinformation per användare för inaktiva användare baserat på de angivna parametrarna.
FindSharedState(String, Int32, Int32, Int32)	Returnerar en samling information om delat anpassningstillstånd baserat på de angivna parametrarna.
FindSharedState(String)	Returnerar en samling information om tillståndet för delad anpassning baserat på den angivna sökvägen.
FindUserState(String, String, Int32, Int32, Int32)	Returnerar en samling personanpassningstillståndsinformation per användare baserat på de angivna parametrarna.
FindUserState(String, String)	Returnerar en samling personanpassningstillståndsinformation per användare baserat på användarnamnet och sidsökvägen.
GetAllInactiveUserState(DateTime, Int32, Int32, Int32)	Returnerar en delmängd av all information om personanpassningstillstånd per användare som är associerad med inaktiva användare baserat på de angivna parametrarna.
GetAllInactiveUserState(DateTime)	Returnerar en samling med all information om personanpassningstillstånd per användare som är associerad med inaktiva användare baserat på det angivna datumet.
GetAllState(PersonalizationScope, Int32, Int32, Int32)	Returnerar en delmängd av all personaliseringstillståndsinformation från det underliggande datalagret baserat på de angivna parametrarna.
GetAllState(PersonalizationScope)	Returnerar en samling med all information om anpassningstillstånd från det underliggande datalagret för det begärda anpassningsomfånget.
GetCountOfInactiveUserState(DateTime)	Returnerar antalet personanpassningsobjekt per användare i det underliggande datalagret för inaktiva användare baserat på den angivna parametern.
GetCountOfInactiveUserState(String, DateTime)	Returnerar antalet personanpassningsobjekt per användare i det underliggande datalagret för inaktiva användare baserat på de angivna parametrarna.
GetCountOfState(PersonalizationScope, String)	Returnerar antalet anpassningstillståndsobjekt i det underliggande datalagret som finns för de angivna parametrarna.
GetCountOfState(PersonalizationScope)	Returnerar antalet anpassningstillståndsobjekt i det underliggande datalagret som finns för det angivna omfånget.
GetCountOfUserState(String)	Returnerar antalet anpassningstillståndsobjekt i det underliggande datalagret som finns för den angivna användaren.
ResetAllState(PersonalizationScope)	Återställer alla anpassningsdata i det underliggande datalagret genom att ta bort alla rader som är associerade med det angivna omfånget.
ResetInactiveUserState(DateTime)	Återställer all information om personanpassningstillstånd per användare i det underliggande datalagret baserat på den angivna parametern.
ResetInactiveUserState(String, DateTime)	Återställer all tillståndsinformation per användare i det underliggande datalagret för inaktiva användare baserat på de angivna parametrarna.
ResetSharedState(String)	Återställer delat tillstånd i det underliggande datalagret för den angivna sökvägen.
ResetSharedState(String[])	Återställer delat tillstånd i det underliggande datalagret för de angivna sökvägarna.
ResetState(PersonalizationStateInfoCollection)	Återställer anpassningsdata i det underliggande datalagret baserat på objekten i samlingen.
ResetUserState(String, String)	Återställer tillståndet per användare i det underliggande datalagret för den angivna kombinationen av användarnamn och sökväg.
ResetUserState(String, String[])	Återställer tillståndet per användare i det underliggande datalagret för sidan och angivna användare.
ResetUserState(String)	Återställer alla tillstånd per användare i det underliggande datalagret för den angivna sökvägen.
ResetUserState(String[])	Återställer alla tillstånd per användare i det underliggande datalagret för de angivna sökvägarna.

Gäller för

Se även

Feedback

Var den här sidan till hjälp?