My.User.IsInRole-Methode

Aktualisiert: November 2007

Bestimmt, ob der aktuelle Benutzer die angegebene Rolle innehat.

' Usage
Dim value As Boolean = My.User.IsInRole(role)
Dim value As Boolean = My.User.IsInRole(role)
' Declaration
Public Function IsInRole( _
   ByVal role As String _
) As Boolean
' -or-
Public Function IsInRole( _
   ByVal role As BuiltInRole _
) As Boolean

Parameter

• role
  String oder BuiltInRole-Enumeration. Die Rolle, für die die Mitgliedschaft überprüft werden soll.

Rückgabewert

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

Hinweise

Die My.User.IsInRole-Methode ermöglicht es dem Code zu bestimmen, ob der aktuelle Benutzer ein Mitglied der angegebenen Rolle ist.

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

Die Überladung der My.User.IsInRole-Methode, die eine BuiltInRole-Enumeration akzeptiert verhält sich je nach dem aktuellen Prinzipal unterschiedlich. Wenn es ein Prinzipal für einen Windows-Benutzer ist (WindowsPrincipal), konvertiert diese Funktion role in die entsprechende WindowsBuiltInRole-Enumeration und gibt das Ergebnis des Aufrufs von IsInRole zurück. Wenn der aktuelle Prinzipal ein anderer Prinzipal ist, übergibt diese Funktion den Namen des Enumerationswerts in role an die IsInRole-Methode des Prinzipals.

Hinweis:
Das jeweilige 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 unter My.User-Objekt.

Aufgaben

Beispiel

In diesem Beispiel wird vor dem Zugriff auf eine Ressource überprüft, ob der Benutzer ein Administrator ist.

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

Anforderungen

Namespace:Microsoft.VisualBasic.ApplicationServices

Klasse:User, WebUser

Assembly: Visual Basic-Laufzeitbibliothek (in Microsoft.VisualBasic.dll)

Verfügbarkeit nach Projekttyp

Berechtigungen

Die folgende Berechtigung ist möglicherweise erforderlich:

Weitere Informationen finden Sie unter Codezugriffssicherheit und unter Anfordern von Berechtigungen.

Siehe auch

Aufgaben

Gewusst wie: Ermitteln, ob ein Benutzer einer Gruppe angehört

Exemplarische Vorgehensweise: Implementieren von benutzerdefinierter Authentifizierung und Autorisierung

Referenz

My.User-Objekt

BuiltInRole-Enumeration

Microsoft.VisualBasic.ApplicationServices.BuiltInRole

User.IsInRole