User.CurrentPrincipal プロパティ

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

User.CurrentPrincipal プロパティ

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

ロールベースのセキュリティに関する、現在のプリンシパルを取得または設定します。

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

Visual Basic (宣言)

Public Property CurrentPrincipal As
 IPrincipal

Visual Basic (使用法)

Dim instance As User
Dim value As IPrincipal

value = instance.CurrentPrincipal

instance.CurrentPrincipal = value

C#

public IPrincipal CurrentPrincipal { get; set;
 }

C++

public:
property IPrincipal^ CurrentPrincipal {
    IPrincipal^ get ();
    void set (IPrincipal^ value);
}

J#

/** @property */
public IPrincipal get_CurrentPrincipal ()

/** @property */
public void set_CurrentPrincipal (IPrincipal
 value)

JScript

public function get CurrentPrincipal
 () : IPrincipal

public function set CurrentPrincipal
 (value : IPrincipal)

プロパティ値
セキュリティ コンテキストを表す IPrincipal 値。

解説

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

カスタム認証を有効にするには、My.User.CurrentPrincipal プロパティを、IPrincipal インターフェイスを実装するオブジェクトに設定します。

大半のプロジェクトの種類では、スレッドの現在のプリンシパルが取得または設定されます。ASP.NET アプリケーションの場合は、現在の HTTP 要求のユーザー ID について、セキュリティ情報が取得または設定されます。

これは詳細メンバであり、[すべての候補] タブをクリックしないと IntelliSense に表示されません。

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

プラットフォーム

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 クラス
User メンバ
Microsoft.VisualBasic.ApplicationServices 名前空間
System.Security.Principal.IPrincipal
User.CurrentPrincipal プロパティ
その他の技術情報
My.User.CurrentPrincipal プロパティ
My.User オブジェクト
方法 : ユーザーのログイン名を確認する
方法 : ユーザーのドメインを確認する
チュートリアル : カスタムの認証および承認の実装