Freigeben über


User.IsInRole Methode

Definition

Bestimmt, ob der aktuelle Benutzer zur angegebenen Rolle gehört.

Überlädt

IsInRole(BuiltInRole)

Bestimmt, ob der aktuelle Benutzer zur angegebenen Rolle gehört.

IsInRole(String)

Bestimmt, ob der aktuelle Benutzer zur angegebenen Rolle gehört.

IsInRole(BuiltInRole)

Bestimmt, ob der aktuelle Benutzer zur angegebenen Rolle gehört.

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

Die integrierte Windows-Rolle, für die die Mitgliedschaft überprüft werden soll.

Gibt zurück

True, wenn der aktuelle Benutzer ein Mitglied der angegebenen Rolle ist, andernfalls False.

Beispiele

In diesem Beispiel wird überprüft, ob der Benutzer Administrator ist, bevor er auf eine Ressource zugreift.

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 ermitteln, ob der aktuelle Benutzer Mitglied der angegebenen Rolle ist.

Die Überladung der Methode, die My.User.IsInRole eine Zeichenfolge akzeptiert, ermöglicht einfachen Zugriff auf die IsInRole Methode des aktuellen Prinzipals.

Die Überladung der Methode, die My.User.IsInRole eine BuiltInRole Enumeration akzeptiert, verhält sich je nach aktuellem Prinzipal unterschiedlich. Wenn es sich um einen Windows-Benutzerprinzipal handelt (WindowsPrincipal), konvertiert diese Funktion in role die entsprechende WindowsBuiltInRole Enumeration und gibt das Ergebnis des Aufrufens IsInRolezurück. Wenn der aktuelle Prinzipal ein anderer Prinzipal ist, übergibt diese Funktion den Namen des Enumerationswerts in role an die Methode des IsInRole Prinzipals.

Hinweis

Das genaue Verhalten des My.User Objekts hängt vom Typ der Anwendung und vom Betriebssystem ab, unter dem die Anwendung ausgeführt wird. Weitere Informationen finden Sie in der User Klassenübersicht.

Verfügbarkeit nach Projekttyp

Projekttyp Verfügbar
Windows-Anwendung Ja
Klassenbibliothek Ja
Konsolenanwendung Ja
Windows-Steuerelementbibliothek Ja
Websteuerelementbibliothek Ja
Windows-Dienst Ja
Website Ja

Weitere Informationen

Gilt für:

IsInRole(String)

Bestimmt, ob der aktuelle Benutzer zur angegebenen Rolle gehört.

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

Der Name der Rolle, für die die Mitgliedschaft überprüft werden soll.

Gibt zurück

True, wenn der aktuelle Benutzer ein Mitglied der angegebenen Rolle ist, andernfalls False.

Beispiele

In diesem Beispiel wird überprüft, ob der Benutzer Administrator ist, bevor er auf eine Ressource zugreift.

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 ermitteln, ob der aktuelle Benutzer Mitglied der angegebenen Rolle ist.

Die Überladung der Methode, die My.User.IsInRole eine Zeichenfolge akzeptiert, ermöglicht einfachen Zugriff auf die IsInRole Methode des aktuellen Prinzipals.

Die Überladung der Methode, die My.User.IsInRole eine BuiltInRole Enumeration akzeptiert, verhält sich je nach aktuellem Prinzipal unterschiedlich. Wenn es sich um einen Windows-Benutzerprinzipal handelt (WindowsPrincipal), konvertiert diese Funktion in role die entsprechende WindowsBuiltInRole Enumeration und gibt das Ergebnis des Aufrufens IsInRolezurück. Wenn der aktuelle Prinzipal ein anderer Prinzipal ist, übergibt diese Funktion den Namen des Enumerationswerts in role an die Methode des IsInRole Prinzipals.

Hinweis

Das genaue Verhalten des My.User Objekts hängt vom Typ der Anwendung und vom Betriebssystem ab, unter dem die Anwendung ausgeführt wird. Weitere Informationen finden Sie in der User Klassenübersicht.

Verfügbarkeit nach Projekttyp

Projekttyp Verfügbar
Windows-Anwendung Ja
Klassenbibliothek Ja
Konsolenanwendung Ja
Windows-Steuerelementbibliothek Ja
Websteuerelementbibliothek Ja
Windows-Dienst Ja
Website Ja

Weitere Informationen

Gilt für: