WebUser クラス
アセンブリ: Microsoft.VisualBasic (microsoft.visualbasic.dll 内)
構文
解説詳細については、Visual Basic のトピック「My.User オブジェクト」を参照してください。
My.User オブジェクトが公開するプロパティおよびメソッドを使用すると、現在のユーザーに関する情報にアクセスできます。"現在のユーザー" は、Windows アプリケーションと Web アプリケーションとではやや意味が異なります。Windows アプリケーションの場合、現在のユーザーとは、アプリケーションを実行しているユーザーを指します。Web アプリケーションの場合、現在のユーザーとは、アプリケーションにアクセスしているユーザーを指します。
また、My.User プロパティを使用すると、現在のユーザーの IPrincipal にアクセスすることもできます。プリンシパル オブジェクトは、ユーザー ID や割り当てられているロールを含む、ユーザーのセキュリティ コンテキストを表します。
Windows アプリケーションの場合、このプロパティは CurrentPrincipal プロパティと同じ機能を提供します。Web アプリケーションの場合、このプロパティは、Current プロパティによって返されるオブジェクトの User プロパティと同じ機能を提供します。
メモ |
|---|
| Windows アプリケーションの場合、[Windows アプリケーション] テンプレートを使ってビルドされたプロジェクトについてのみ、My.User オブジェクトが既定で初期化されます。その他の種類の Windows プロジェクトではすべて、My.User.InitializeWithWindowsUser メソッド を明示的に呼び出すか、CurrentPrincipal に値を代入することによって、My.User オブジェクトを初期化する必要があります。 |
メモ |
|---|
| Windows 95 および Windows 98 のオペレーティング システムにはログオン ユーザーの概念がないため、My.User オブジェクトを使って、現在の Windows ユーザーに関する情報を取得することはできません。これらのオペレーティング システムで My.User オブジェクトを使用するには、カスタム認証を実装する必要があります。詳細については、「チュートリアル : カスタムの認証および承認の実装」を参照してください。 |
My.User オブジェクトを使ったタスクの例を次の表に示します。
使用例この例では、アプリケーションに Windows 認証またはカスタム認証が使用されているかをチェックし、その情報を使用して、My.User.Name プロパティを解析しています。
Function GetUserName() As String If TypeOf My.User.CurrentPrincipal Is _ Security.Principal.WindowsPrincipal Then ' The application is using Windows authentication. ' The name format is DOMAIN\USERNAME. Dim parts() As String = Split(My.User.Name, "\") Dim username As String = parts(1) Return username Else ' The application is using custom authentication. Return My.User.Name End If End Function
継承階層Microsoft.VisualBasic.ApplicationServices.User
Microsoft.VisualBasic.ApplicationServices.WebUser
スレッド セーフ
プラットフォーム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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報
参照WebUser コンストラクタ
アセンブリ: Microsoft.VisualBasic (microsoft.visualbasic.dll 内)
構文
解説詳細については、Visual Basic のトピック「My.User オブジェクト」を参照してください。
My.User オブジェクトが公開するプロパティおよびメソッドを使用すると、現在のユーザーに関する情報にアクセスできます。
プラットフォーム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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報
参照WebUser プロパティ
パブリック プロパティ| 名前 | 説明 | |
|---|---|---|
| CurrentPrincipal | ロールベースのセキュリティに関する、現在のプリンシパルを取得または設定します。 ( User から継承されます。) |
| IsAuthenticated | ユーザーが認証されているかどうかを示す値を取得します。 ( User から継承されます。) |
| Name | 現在のユーザーの名前を取得します。 ( User から継承されます。) |
プロテクト プロパティ
参照WebUser メソッド
パブリック メソッド| 名前 | 説明 | |
|---|---|---|
| Equals | オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。) |
| GetHashCode | 特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。) |
| GetType | 現在のインスタンスの Type を取得します。 ( Object から継承されます。) |
| InitializeWithWindowsUser | スレッドの現在のプリンシパルを、アプリケーションを起動した Windows ユーザーに設定します。 ( User から継承されます。) |
| IsInRole | オーバーロードされます。 現在のユーザーが、指定したロールに属しているかどうかを確認します。 ( User から継承されます。) |
| ReferenceEquals | 指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。) |
| ToString | 現在の Object を表す String を返します。 ( Object から継承されます。) |
プロテクト メソッド| 名前 | 説明 | |
|---|---|---|
| Finalize | Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。) |
| MemberwiseClone | 現在の Object の簡易コピーを作成します。 ( Object から継承されます。) |
参照WebUser メンバ
WebUser データ型で公開されるメンバを以下の表に示します。
パブリック コンストラクタ
パブリック プロパティ| 名前 | 説明 | |
|---|---|---|
| CurrentPrincipal | ロールベースのセキュリティに関する、現在のプリンシパルを取得または設定します。(User から継承されます。) |
| IsAuthenticated | ユーザーが認証されているかどうかを示す値を取得します。(User から継承されます。) |
| Name | 現在のユーザーの名前を取得します。 (User から継承されます。) |
プロテクト プロパティ
パブリック メソッド| 名前 | 説明 | |
|---|---|---|
| Equals | オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。) |
| GetHashCode | 特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。) |
| GetType | 現在のインスタンスの Type を取得します。 (Object から継承されます。) |
| InitializeWithWindowsUser | スレッドの現在のプリンシパルを、アプリケーションを起動した Windows ユーザーに設定します。 (User から継承されます。) |
| IsInRole | オーバーロードされます。 現在のユーザーが、指定したロールに属しているかどうかを確認します。 (User から継承されます。) |
| ReferenceEquals | 指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。) |
| ToString | 現在の Object を表す String を返します。 (Object から継承されます。) |
プロテクト メソッド| 名前 | 説明 | |
|---|---|---|
| Finalize | Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。) |
| MemberwiseClone | 現在の Object の簡易コピーを作成します。 (Object から継承されます。) |
参照- WebUserのページへのリンク
.gif)