User.IsInRole User.IsInRole User.IsInRole User.IsInRole Method

Definition

Bestimmt, ob der aktuelle Benutzer zur angegebenen Rolle gehört.Determines whether the current user belongs to the specified role.

Überlädt

IsInRole(BuiltInRole) IsInRole(BuiltInRole) IsInRole(BuiltInRole) IsInRole(BuiltInRole)

Bestimmt, ob der aktuelle Benutzer zur angegebenen Rolle gehört.Determines whether the current user belongs to the specified role.

IsInRole(String) IsInRole(String) IsInRole(String) IsInRole(String)

Bestimmt, ob der aktuelle Benutzer zur angegebenen Rolle gehört.Determines whether the current user belongs to the specified role.

IsInRole(BuiltInRole) IsInRole(BuiltInRole) IsInRole(BuiltInRole) IsInRole(BuiltInRole)

Bestimmt, ob der aktuelle Benutzer zur angegebenen Rolle gehört.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

Parameter

role
BuiltInRole BuiltInRole BuiltInRole BuiltInRole

Die integrierte Windows-Rolle, für die die Mitgliedschaft überprüft werden soll.The built-in Windows role for which to check membership.

Gibt zurück

True, wenn der aktuelle Benutzer ein Mitglied der angegebenen Rolle ist, andernfalls False.True if the current user is a member of the specified role; otherwise, False.

Beispiele

In diesem Beispiel wird überprüft, ob der Benutzer ein Administrator ist, bevor auf eine Ressource zugegriffen wird.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

Hinweise

Mit My.User.IsInRole der-Methode kann Ihr Code bestimmen, ob der aktuelle Benutzer ein Mitglied der angegebenen Rolle ist.The My.User.IsInRole method allows your code to determine if the current user is a member of the specified role.

Die-über My.User.IsInRole Ladung der-Methode, die eine Zeichenfolge annimmt, IsInRole bietet einfachen Zugriff auf die-Methode des aktuellen Prinzipals.The overload of the My.User.IsInRole method that takes a string provides easy access to the IsInRole method of the current principal.

Die-Überladung der- BuiltInRole Methode,dieeine-Enumerationannimmt,verhältsichabhängigvomaktuellenPrinzipalanders.My.User.IsInRoleThe overload of the My.User.IsInRole method that takes a BuiltInRole enumeration behaves differently, depending on the current principal. Wenn es sich um einen Windows-BenutzerWindowsPrincipalPrinzipal () handelt role , konvertiert diese WindowsBuiltInRole Funktion in die entsprechende-Enumeration und IsInRolegibt das Ergebnis des Aufrufs von zurück.If it is a Windows user principal (WindowsPrincipal), this function converts role to the equivalent WindowsBuiltInRole enumeration and returns the result of calling IsInRole. Wenn der aktuelle Prinzipal ein beliebiger anderer Prinzipal ist, übergibt diese Funktion den Namen des Enumerationswerts role in IsInRole an die-Methode des Prinzipals.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.

Hinweis

Das genaue Verhalten des My.User Objekts hängt vom Typ der Anwendung und von dem Betriebssystem ab, auf dem die Anwendung ausgeführt wird.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. Weitere Informationen finden Sie in der User Übersicht über die-Klasse.For more information, see the User class overview.

Verfügbarkeit nach ProjekttypAvailability by Project Type

Projekttyp:Project type VerfügbarAvailable
Windows-AnwendungWindows Application JaYes
KlassenbibliothekClass Library JaYes
KonsolenanwendungConsole Application JaYes
Windows-Steuerelement BibliothekWindows Control Library JaYes
Websteuer Element BibliothekWeb Control Library JaYes
Windows-DienstWindows Service JaYes
WebsiteWeb Site JaYes

Sicherheit

SecurityPermission
Beschreibt einen auf Code angewendeten Satz von Sicherheitsberechtigungen.Describes a set of security permissions applied to code. Zugeordnete Enumeration: ControlPrincipalAssociated enumeration: ControlPrincipal.

Siehe auch

IsInRole(String) IsInRole(String) IsInRole(String) IsInRole(String)

Bestimmt, ob der aktuelle Benutzer zur angegebenen Rolle gehört.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

Parameter

role
String String String String

Der Name der Rolle, für die die Mitgliedschaft überprüft werden soll.The name of the role for which to check membership.

Gibt zurück

True, wenn der aktuelle Benutzer ein Mitglied der angegebenen Rolle ist, andernfalls False.True if the current user is a member of the specified role; otherwise, False.

Beispiele

In diesem Beispiel wird überprüft, ob der Benutzer ein Administrator ist, bevor auf eine Ressource zugegriffen wird.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

Hinweise

Mit My.User.IsInRole der-Methode kann Ihr Code bestimmen, ob der aktuelle Benutzer ein Mitglied der angegebenen Rolle ist.The My.User.IsInRole method allows your code to determine if the current user is a member of the specified role.

Die-über My.User.IsInRole Ladung der-Methode, die eine Zeichenfolge annimmt, IsInRole bietet einfachen Zugriff auf die-Methode des aktuellen Prinzipals.The overload of the My.User.IsInRole method that takes a string provides easy access to the IsInRole method of the current principal.

Die-Überladung der- BuiltInRole Methode,dieeine-Enumerationannimmt,verhältsichabhängigvomaktuellenPrinzipalanders.My.User.IsInRoleThe overload of the My.User.IsInRole method that takes a BuiltInRole enumeration behaves differently, depending on the current principal. Wenn es sich um einen Windows-BenutzerWindowsPrincipalPrinzipal () handelt role , konvertiert diese WindowsBuiltInRole Funktion in die entsprechende-Enumeration und IsInRolegibt das Ergebnis des Aufrufs von zurück.If it is a Windows user principal (WindowsPrincipal), this function converts role to the equivalent WindowsBuiltInRole enumeration and returns the result of calling IsInRole. Wenn der aktuelle Prinzipal ein beliebiger anderer Prinzipal ist, übergibt diese Funktion den Namen des Enumerationswerts role in IsInRole an die-Methode des Prinzipals.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.

Hinweis

Das genaue Verhalten des My.User Objekts hängt vom Typ der Anwendung und von dem Betriebssystem ab, auf dem die Anwendung ausgeführt wird.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. Weitere Informationen finden Sie in der User Übersicht über die-Klasse.For more information, see the User class overview.

Verfügbarkeit nach ProjekttypAvailability by Project Type

Projekttyp:Project type VerfügbarAvailable
Windows-AnwendungWindows Application JaYes
KlassenbibliothekClass Library JaYes
KonsolenanwendungConsole Application JaYes
Windows-Steuerelement BibliothekWindows Control Library JaYes
Websteuer Element BibliothekWeb Control Library JaYes
Windows-DienstWindows Service JaYes
WebsiteWeb Site JaYes

Sicherheit

SecurityPermission
Beschreibt einen auf Code angewendeten Satz von Sicherheitsberechtigungen.Describes a set of security permissions applied to code. Zugeordnete Enumeration: ControlPrincipalAssociated enumeration: ControlPrincipal.

Siehe auch

Gilt für: