My.User.Name プロパティ

[アーティクル]
08/16/2008

更新 : 2007 年 11 月

現在のユーザーのユーザー名を取得します。

' Usage
Dim value As String = My.User.Name
' Declaration
Public ReadOnly Property Name As String

戻り値

String。現在のユーザーのユーザー名です。

解説

My.User オブジェクトを使用して、現在のユーザーに関する情報を取得できます。

ユーザーを認証するプリンシパルも、ユーザー名の形式に適用されます。既定で、アプリケーションでは Windows 認証が使用され、ユーザー名の形式は DOMAIN\USERNAME となります。独自に実装されたプリンシパルでは、これと同じ形式は必ずしも使用されません。

メモ :
My.User.Name プロパティは、ユーザー名を認識しないオペレーティングシステムである Windows 95 または Windows 98 で実行された場合に空の文字列を返します。

メモ :
My.User オブジェクトの動作は、アプリケーションの種類やアプリケーションを実行するオペレーティングシステムによって多少異なります。詳細については、「My.User オブジェクト」を参照してください。

処理手順

My.User.Name プロパティに関連するタスクの例を次の表に示します。

タスク	参照項目
ユーザーのログイン名を取得します。	方法 : ユーザーのログイン名を確認する
ユーザーのドメイン名を取得します (アプリケーションで Windows 認証を使用する場合)。	方法 : ユーザーのドメインを確認する
カスタム認証を実装します。	チュートリアル : カスタムの認証および承認の実装

使用例

このコード例は、アプリケーションで 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、WebUser

アセンブリ : Microsoft Visual Basic ランタイム (Microsoft.VisualBasic.dll 内)

プロジェクトの種類別の可用性

プロジェクトの種類	使用
Windows アプリケーション	可
クラスライブラリ	可
コンソールアプリケーション	可
Windows コントロールライブラリ	可
Web コントロールライブラリ	可
Windows サービス	可
Web サイト	可

アクセス許可

以下のアクセス許可が必要な場合があります。

アクセス許可	説明
SecurityPermission	コードに適用される一連のセキュリティアクセス許可を記述します。関連する列挙値 : ControlPrincipal。