PersonalizationAdministration クラス
メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。
Web パーツ パーソナル化の管理機能を実装します。このクラスは継承できません。
名前空間: System.Web.UI.WebControls.WebParts
アセンブリ: System.Web (system.web.dll 内)
構文
解説このクラスには、Web パーツ パーソナル化の管理機能を公開する複数の静的メソッドおよびプロパティが用意されています。これらのメソッドは、Web パーツ コントロールの WebPartManager コントロールで構成されている既定のパーソナル化プロバイダに適用されます。パーソナル化プロバイダとして機能する複数のデータ ストアを管理する必要がある場合、パーソナル化プロバイダのそれぞれのクラスにこのメソッドを直接使用する必要があります。WebPartManager コントロールに対して構成されたパーソナル化プロバイダのコレクションは、Providers 静的プロパティから取得できます。
Web アプリケーションが、既定の信頼レベルである Medium、またはそれ以上の信頼レベルで実行されていない場合、パーソナル化は失敗することに注意してください (カスタム信頼レベルは、Web.config ファイルで <trust level="" /> 要素を使用して設定できます)。PersonalizationAdministration クラスと SqlPersonalizationProvider クラスはどちらも、初期化されるときに Low の信頼レベルをチェックします。アプリケーションを Low の信頼レベルで実行するように構成し、既定の SqlPersonalizationProvider プロバイダを使用してアプリケーションのパーソナル化データを管理する場合、アプリケーションがパーソナル化データに最初のアクセスを試みたときに失敗することになります。これは、Low の信頼で実行している ASP.NET ワーカー プロセスには、System.Data.SqlClient 名前空間の各種のクラスに呼び出しを行うために必要なアクセス許可がないためです。
使用例PersonalizationAdministration クラスで複数のメソッドを使用する方法を次のコード例に示します。この例は、Persadmin.ascx という名前の Web パーツ ユーザー コントロールを参照する .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 > <head id="Head1" runat="server"> <title>Untitled Page</title> </head> <body> <form id="form1" runat="server"> <div> <asp:LoginName ID="LoginName1" runat="server" /> <asp:LoginStatus ID="LoginStatus1" runat="server" LogoutAction="RedirectToLoginPage" /> <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 コントロールのコード例を次に示します。
<%@ 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); _provider = PersonalizationAdministration.Provider.Name; TextBox1.Text = _provider; if (_manager.Personalization.Scope == PersonalizationScope.Shared) { TextBox2.Text = "Shared Scope"; } else TextBox2.Text = "User Scope"; Label4.Visible = false; TextBox4.Text = PersonalizationAdministration.GetCountOfState(PersonalizationScope.User).ToString(); } protected void Button1_Click(object sender, EventArgs e) { if (TextBox3.Text != null) { PersonalizationStateInfoCollection findresult; findresult = PersonalizationAdministration.FindUserState(null, TextBox3.Text); if (findresult.Count != 0) { Label4.Text = findresult.Count + " user(s) found"; Label4.Visible = true; } else { Label4.Text = "No users found."; Label4.Visible = true; } } else { Label4.Text = "You must enter a user name to find."; } } </script> <asp:Label ID="Label1" runat="server" Text="Personalization Provider" Width="162px" /> <br /> <asp:TextBox ID="TextBox1" runat="server" Width="268px"></asp:TextBox> <br /> <br /> <asp:Label ID="Label2" runat="server" Text="Scope" /> <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" /> <br /> <asp:TextBox ID="TextBox3" runat="server"></asp:TextBox> <asp:Label ID="Label4" runat="server" Width="77px" ForeColor="Red" /> <br /> <br /> <asp:Button ID="Button1" runat="server" Text="Find User" OnClick="Button1_Click" /> <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" Height="21px" /> <br /> <asp:TextBox ID="TextBox4" runat="server" Width="63px"></asp:TextBox> <br /> <br /> <br /> <br />
.NET Framework のセキュリティ継承階層System.Web.UI.WebControls.WebParts.PersonalizationAdministration
スレッド セーフプラットフォームWindows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照PersonalizationAdministration プロパティ
| 名前 | 説明 | |
|---|---|---|
.gif) | ApplicationName | プロバイダによって指定されたアプリケーションの名前を取得または設定します。 |
| | Provider | 既定のパーソナル化プロバイダのインスタンスを返します。 |
| | Providers | 名前でインデックスが付けられたパーソナル化プロバイダのコレクションを返します。 |
参照PersonalizationAdministration メソッド
.gif)
プロテクト メソッド| 名前 | 説明 | |
|---|---|---|
.gif) | Finalize | Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。) |
| | MemberwiseClone | 現在の Object の簡易コピーを作成します。 ( Object から継承されます。) |
参照PersonalizationAdministration メンバ
Web パーツ パーソナル化の管理機能を実装します。このクラスは継承できません。
PersonalizationAdministration データ型で公開されるメンバを以下の表に示します。
パブリック プロパティ| 名前 | 説明 | |
|---|---|---|
| | ApplicationName | プロバイダによって指定されたアプリケーションの名前を取得または設定します。 |
| | Provider | 既定のパーソナル化プロバイダのインスタンスを返します。 |
| | Providers | 名前でインデックスが付けられたパーソナル化プロバイダのコレクションを返します。 |
パブリック メソッドプロテクト メソッド| 名前 | 説明 | |
|---|---|---|
| | Finalize | Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。) |
| | MemberwiseClone | 現在の Object の簡易コピーを作成します。 (Object から継承されます。) |
参照- PersonalizationAdministrationのページへのリンク
