User.IsInRole メソッド

定義

現在のユーザーが、指定したロールに属しているかどうかを確認します。Determines whether the current user belongs to the specified role.

オーバーロード

IsInRole(BuiltInRole)

現在のユーザーが、指定したロールに属しているかどうかを確認します。Determines whether the current user belongs to the specified role.

IsInRole(String)

現在のユーザーが、指定したロールに属しているかどうかを確認します。Determines whether the current user belongs to the specified role.

IsInRole(BuiltInRole)

現在のユーザーが、指定したロールに属しているかどうかを確認します。Determines whether the current user belongs to the specified role.

public:
 bool IsInRole(Microsoft::VisualBasic::ApplicationServices::BuiltInRole role);
public bool IsInRole (Microsoft.VisualBasic.ApplicationServices.BuiltInRole role);
member this.IsInRole : Microsoft.VisualBasic.ApplicationServices.BuiltInRole -> bool
Public Function IsInRole (role As BuiltInRole) As Boolean

パラメーター

role
BuiltInRole

メンバーシップの確認対象となる組み込みの Windows ロール。The built-in Windows role for which to check membership.

戻り値

現在のユーザーが指定されたロールのメンバーである場合は True。それ以外の場合は FalseTrue if the current user is a member of the specified role; otherwise, False.

この例では、リソースにアクセスする前に、ユーザーが管理者であるかどうかを確認します。This example checks if the user is an administrator before accessing a resource.

If My.User.IsInRole( 
        ApplicationServices.BuiltInRole.Administrator) Then
    ' Insert code to access a resource here.
End If

注釈

My.User.IsInRoleメソッドを使用すると、現在のユーザーが指定されたロールのメンバーであるかどうかをコードで判断できます。The My.User.IsInRole method allows your code to determine if the current user is a member of the specified role.

文字列を受け取るMy.User.IsInRoleメソッドのオーバーロードにより、現在のプリンシパルのIsInRoleメソッドに簡単にアクセスできるようになります。The overload of the My.User.IsInRole method that takes a string provides easy access to the IsInRole method of the current principal.

列挙体をBuiltInRole受け取るMy.User.IsInRoleメソッドのオーバーロードは、現在のプリンシパルによって動作が異なります。The overload of the My.User.IsInRole method that takes a BuiltInRole enumeration behaves differently, depending on the current principal. Windows ユーザーWindowsPrincipalプリンシパル () の場合、この関数は同等WindowsBuiltInRolerole列挙型に変換し、を呼び出しIsInRoleた結果を返します。If it is a Windows user principal (WindowsPrincipal), this function converts role to the equivalent WindowsBuiltInRole enumeration and returns the result of calling IsInRole. 現在のプリンシパルがその他のプリンシパルである場合、この関数は、のrole列挙値の名前をプリンシパルのIsInRoleメソッドに渡します。If the current principal is any other principal, this function passes the name of the enumeration value in role to the principal's IsInRole method.

注意

My.Userオブジェクトの正確な動作は、アプリケーションの種類と、アプリケーションが実行されているオペレーティングシステムによって異なります。The exact behavior of the My.User object depends on the type of the application and on the operating system on which the application runs. 詳細については、 Userクラスの概要に関するトピックを参照してください。For more information, see the User class overview.

プロジェクトの種類別の可用性Availability by Project Type

プロジェクトの種類Project type 使用可能Available
Windows アプリケーションWindows Application はいYes
クラス ライブラリClass Library はいYes
コンソール アプリケーションConsole Application はいYes
Windows コントロールライブラリWindows Control Library はいYes
Web コントロールライブラリWeb Control Library はいYes
Windows サービスWindows Service はいYes
Web サイトWeb Site はいYes

セキュリティ

SecurityPermission
コードに適用されるセキュリティ アクセス許可のセットを記述します。Describes a set of security permissions applied to code. ControlPrincipal (関連する列挙体)Associated enumeration: ControlPrincipal.

こちらもご覧ください

IsInRole(String)

現在のユーザーが、指定したロールに属しているかどうかを確認します。Determines whether the current user belongs to the specified role.

public:
 bool IsInRole(System::String ^ role);
public bool IsInRole (string role);
member this.IsInRole : string -> bool
Public Function IsInRole (role As String) As Boolean

パラメーター

role
String

メンバーシップを確認する対象のロールの名前。The name of the role for which to check membership.

戻り値

現在のユーザーが指定されたロールのメンバーである場合は True。それ以外の場合は FalseTrue if the current user is a member of the specified role; otherwise, False.

この例では、リソースにアクセスする前に、ユーザーが管理者であるかどうかを確認します。This example checks if the user is an administrator before accessing a resource.

If My.User.IsInRole( 
        ApplicationServices.BuiltInRole.Administrator) Then
    ' Insert code to access a resource here.
End If

注釈

My.User.IsInRoleメソッドを使用すると、現在のユーザーが指定されたロールのメンバーであるかどうかをコードで判断できます。The My.User.IsInRole method allows your code to determine if the current user is a member of the specified role.

文字列を受け取るMy.User.IsInRoleメソッドのオーバーロードにより、現在のプリンシパルのIsInRoleメソッドに簡単にアクセスできるようになります。The overload of the My.User.IsInRole method that takes a string provides easy access to the IsInRole method of the current principal.

列挙体をBuiltInRole受け取るMy.User.IsInRoleメソッドのオーバーロードは、現在のプリンシパルによって動作が異なります。The overload of the My.User.IsInRole method that takes a BuiltInRole enumeration behaves differently, depending on the current principal. Windows ユーザーWindowsPrincipalプリンシパル () の場合、この関数は同等WindowsBuiltInRolerole列挙型に変換し、を呼び出しIsInRoleた結果を返します。If it is a Windows user principal (WindowsPrincipal), this function converts role to the equivalent WindowsBuiltInRole enumeration and returns the result of calling IsInRole. 現在のプリンシパルがその他のプリンシパルである場合、この関数は、のrole列挙値の名前をプリンシパルのIsInRoleメソッドに渡します。If the current principal is any other principal, this function passes the name of the enumeration value in role to the principal's IsInRole method.

注意

My.Userオブジェクトの正確な動作は、アプリケーションの種類と、アプリケーションが実行されているオペレーティングシステムによって異なります。The exact behavior of the My.User object depends on the type of the application and on the operating system on which the application runs. 詳細については、 Userクラスの概要に関するトピックを参照してください。For more information, see the User class overview.

プロジェクトの種類別の可用性Availability by Project Type

プロジェクトの種類Project type 使用可能Available
Windows アプリケーションWindows Application はいYes
クラス ライブラリClass Library はいYes
コンソール アプリケーションConsole Application はいYes
Windows コントロールライブラリWindows Control Library はいYes
Web コントロールライブラリWeb Control Library はいYes
Windows サービスWindows Service はいYes
Web サイトWeb Site はいYes

セキュリティ

SecurityPermission
コードに適用されるセキュリティ アクセス許可のセットを記述します。Describes a set of security permissions applied to code. ControlPrincipal (関連する列挙体)Associated enumeration: ControlPrincipal.

こちらもご覧ください

適用対象