LoginView イベント

名前 | 説明 | |
---|---|---|
![]() | DataBinding | サーバー コントロールがデータ ソースに連結すると発生します。 ( Control から継承されます。) |
![]() | Disposed | サーバー コントロールがメモリから解放されると発生します。これは、ASP.NET ページが要求されている場合のサーバー コントロールの有効期間における最終段階です。 ( Control から継承されます。) |
![]() | Init | サーバー コントロールが初期化されると発生します。これは、サーバー コントロールの有効期間における最初の手順です。 ( Control から継承されます。) |
![]() | Load | サーバー コントロールが Page オブジェクトに読み込まれると発生します。 ( Control から継承されます。) |
![]() | PreRender | Control オブジェクトの読み込み後、表示を開始する前に発生します。 ( Control から継承されます。) |
![]() | Unload | サーバー コントロールがメモリからアンロードされると発生します。 ( Control から継承されます。) |
![]() | ViewChanged | ビューの変更後に発生します。 |
![]() | ViewChanging | ビューの変更前に発生します。 |

LoginView クラス
アセンブリ: System.Web (system.web.dll 内)

<BindableAttribute(False)> _ <ThemeableAttribute(True)> _ Public Class LoginView Inherits Control Implements INamingContainer
[BindableAttribute(false)] [ThemeableAttribute(true)] public class LoginView : Control, INamingContainer
[BindableAttribute(false)] [ThemeableAttribute(true)] public ref class LoginView : public Control, INamingContainer

LoginView コントロールは、ユーザーが認証済みかどうか、および認証済みの場合はユーザーが属する Web サイト ロールに基づいて、ユーザーごとに異なる Web サイト コンテンツ テンプレート (または "ビュー") を表示します。
AnonymousTemplate プロパティに格納されているテンプレートは、Web サイトにアクセスし、ログインしていないすべてのユーザーに表示されます。ユーザーがログインすると、サイトの表示は RoleGroups プロパティのいずれかのユーザー ロールに関連付けられているテンプレート、または LoggedInTemplate プロパティで指定された既定のテンプレートのどちらかになります。
LoginView クラスの 3 つのテンプレート プロパティのいずれかにテンプレートを割り当てると、その後は LoginView コントロールが各種テンプレートの切り替えを管理します。
-
AnonymousTemplate Web サイトにログインしていないユーザーに表示するテンプレートを指定します。ログインしているユーザーには、このテンプレートは表示されません。
-
LoggedInTemplate Web サイトにログインしているユーザーで、定義済みテンプレートのいずれのロール グループにも属していないユーザーに表示する既定のテンプレートを指定します。
-
RoleGroups ログインしているユーザーで、定義済みロール グループ テンプレートのロール メンバでもあるユーザーに表示するテンプレートを指定します。コンテンツ テンプレートは、RoleGroup インスタンスの特定のロール セットに関連付けられます。
ロール グループ テンプレートは、ソースに定義されている順序で検索されます。最初に一致するロール グループ テンプレートがユーザーに表示されます。ユーザーが複数のロールのメンバの場合は、ユーザーのいずれかのロールに最初に一致するロール グループ テンプレートが使用されます。1 つのロールに複数のテンプレートが関連付けられている場合は、最初に定義されているテンプレートだけが使用されます。
テンプレートをさまざまな組み合わせで使用した場合の LoginView コントロールの動作を次の表に示します。
RoleGroups プロパティ | LoginView の動作 | ||
---|---|---|---|
設定なし | 設定なし | 設定なし | |
設定なし | 設定なし | ||
設定なし | 設定なし | ||
設定なし | 設定なし | ユーザーのいずれかのロールに一致する、RoleGroups コレクションの最初のテンプレートを表示します。一致するものがない場合は、コンテンツを表示しません。 | |
設定なし | ユーザーがログインしている場合は、LoggedInTemplate プロパティで指定されたテンプレートを表示します。ユーザーがログインしていない場合は、AnonymousTemplate プロパティで指定されたテンプレートを表示します。 | ||
ユーザーがログインしている場合は、ユーザーのいずれかのロールに一致する、RoleGroups コレクションの最初のテンプレートを表示します。一致するものがない場合は、LoggedInTemplate プロパティで指定されたテンプレートを表示します。ユーザーがログインしていない場合は、AnonymousTemplate プロパティで指定されたテンプレートを表示します。 | |||
設定なし | ユーザーがログインしている場合は、ユーザーのいずれかのロールに一致する、RoleGroups コレクションの最初のテンプレートを表示します。一致するものがない場合は、LoggedInTemplate プロパティで指定されたテンプレートを表示します。ユーザーがログインしていない場合は、何も表示されません。 | ||
設定なし | ユーザーがログインしている場合は、ユーザーのいずれかのロールに一致する、RoleGroups コレクションの最初のテンプレートを表示します。一致するものがない場合は、何も表示されません。ユーザーがログインしていない場合は、AnonymousTemplate プロパティで指定されたテンプレートを表示します。 |
AnonymousTemplate と LoggedInTemplate は、Page オブジェクトの User プロパティの Name プロパティを設定する認証方式で使用できます。RoleGroups プロパティを使用して、Web サイトのユーザーのロールに基づいてテンプレートを定義するには、ロール管理を設定する必要があります。詳細については、「ロール管理について」を参照してください。
Focus メソッドでは、LoginView コントロールまたはその子コントロールに Web ページの初期フォーカスを設定しません。LoginView コントロールに格納されるコントロールは、PreRender イベントの後で作成されます。LoginView に格納される子コントロールにフォーカスを設定するには、On_PreRender を処理してから、その Focus メソッドを呼び出します。ViewChanging イベントと ViewChanged イベントを使用し、LoginView コントロール テンプレート内のコントロールにプログラムによってアクセスすることもできます。

LoginView コントロールがサポートする 3 種類のテンプレートのそれぞれについてテンプレートを設定する方法のコード例を次に示します。
<%@ Page Language="VB" %> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <SCRIPT runat="server"> </SCRIPT> <HTML> <BODY> <FORM runat="server"> <P> <asp:LoginStatus id="LoginStatus1" runat="server"></asp:LoginStatus></P> <P> <asp:LoginView id="LoginView1" runat="server"> <AnonymousTemplate> Please log in for personalized information. </AnonymousTemplate> <LoggedInTemplate> Thanks for logging in <asp:LoginName id="LoginName1" runat="Server"></asp:LoginName>. </LoggedInTemplate> <RoleGroups> <asp:RoleGroup Roles="Admin"> <ContentTemplate> <asp:LoginName id="LoginName2" runat="Server"></asp:LoginName>, you are logged in as an administrator. </ContentTemplate> </asp:RoleGroup> </RoleGroups> </asp:LoginView></P> </FORM> </BODY> </HTML>
<%@ Page Language="C#" %> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <SCRIPT runat="server"> </SCRIPT> <HTML> <BODY> <FORM runat="server"> <P> <asp:LoginStatus id="LoginStatus1" runat="server"></asp:LoginStatus></P> <P> <asp:LoginView id="LoginView1" runat="server"> <AnonymousTemplate> Please log in for personalized information. </AnonymousTemplate> <LoggedInTemplate> Thanks for logging in <asp:LoginName id="LoginName1" runat="Server"></asp:LoginName>. </LoggedInTemplate> <RoleGroups> <asp:RoleGroup Roles="Admin"> <ContentTemplate> <asp:LoginName id="LoginName2" runat="Server"></asp:LoginName>, you are logged in as an administrator. </ContentTemplate> </asp:RoleGroup> </RoleGroups> </asp:LoginView></P> </FORM> </BODY> </HTML>


System.Web.UI.Control
System.Web.UI.WebControls.LoginView


Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


LoginView コンストラクタ
アセンブリ: System.Web (system.web.dll 内)


Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


LoginView プロパティ



LoginView メソッド



LoginView メンバ
ユーザーの認証ステータスおよびロール メンバシップに基づいて、指定されたユーザーに適したコンテンツ テンプレートを表示します。
LoginView データ型で公開されるメンバを以下の表に示します。






名前 | 説明 | |
---|---|---|
![]() | DataBinding | サーバー コントロールがデータ ソースに連結すると発生します。(Control から継承されます。) |
![]() | Disposed | サーバー コントロールがメモリから解放されると発生します。これは、ASP.NET ページが要求されている場合のサーバー コントロールの有効期間における最終段階です。(Control から継承されます。) |
![]() | Init | サーバー コントロールが初期化されると発生します。これは、サーバー コントロールの有効期間における最初の手順です。(Control から継承されます。) |
![]() | Load | サーバー コントロールが Page オブジェクトに読み込まれると発生します。(Control から継承されます。) |
![]() | PreRender | Control オブジェクトの読み込み後、表示を開始する前に発生します。(Control から継承されます。) |
![]() | Unload | サーバー コントロールがメモリからアンロードされると発生します。(Control から継承されます。) |
![]() | ViewChanged | ビューの変更後に発生します。 |
![]() | ViewChanging | ビューの変更前に発生します。 |

- LoginViewのページへのリンク