User クラス

.NET Framework クラス ライブラリ リファレンス

User クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

現在のユーザーに関する情報にアクセスします。

名前空間: Microsoft.VisualBasic.ApplicationServices
アセンブリ: Microsoft.VisualBasic (microsoft.visualbasic.dll 内)
構文

Visual Basic (宣言)

Public Class User

Visual Basic (使用法)

Dim instance As User

C#

public class User

C++

public ref class User

J#

public class User

JScript

public class User

解説

詳細については、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 認証が使用されている場合、ユーザーのドメイン名を取得する。	方法 : ユーザーのドメインを確認する
ユーザーのロールを確認する。	方法 : ユーザーがグループに属しているかどうかを確認する
カスタム認証を実装する。	チュートリアル : カスタムの認証および承認の実装

使用例

この例では、アプリケーションに Windows 認証またはカスタム認証が使用されているかをチェックし、その情報を使用して、My.User.Name プロパティを解析しています。

Visual Basic

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

継承階層

System.Object
  Microsoft.VisualBasic.ApplicationServices.User
     Microsoft.VisualBasic.ApplicationServices.WebUser

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
User メンバ
Microsoft.VisualBasic.ApplicationServices 名前空間
IPrincipal
CurrentPrincipal
User
Current
その他の技術情報
My.User オブジェクト
My.User オブジェクトのメンバ