User.Name プロパティとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

User.Name プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

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

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

Visual Basic (宣言)

Public ReadOnly Property
 Name As String

Visual Basic (使用法)

Dim instance As User
Dim value As String

value = instance.Name

public string Name { get;
 }

C++

public:
property String^ Name {
    String^ get ();
}

/** @property */
public String get_Name ()

JScript

public function get Name
 () : String

プロパティ値
現在のユーザーの名前を表す String 値。

解説

詳細については、Visual Basic のトピック「My.User.Name プロパティ」を参照してください。

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

ユーザー名の形式は、ユーザーを認証するプリンシパルに依存します。既定では、アプリケーションに Windows 認証が使用され、ユーザー名には DOMAIN\USERNAME の形式が使用されます。カスタム実装のプリンシパルでは、必ずしもこれと同じ形式にする必要はありません。

メモ
Windows 95 および Windows 98 のオペレーティングシステムでは、ユーザー名が認識されないため、My.User.Name プロパティからは空の文字列が返されます。

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

My.User.Name プロパティを使ったタスクの例を次の表に示します。

目的	参照項目
ユーザーのログオン名を取得する。	方法 : ユーザーのログイン名を確認する
アプリケーションに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