User.IsInRole Methode

Definition

Namespace:
Microsoft.VisualBasic.ApplicationServices
Assembly:
Microsoft.VisualBasic.dll

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

Überlädt

Name Beschreibung
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

Boolean

Truewenn der aktuelle Benutzer Mitglied der angegebenen Rolle ist; andernfalls . False

Beispiele

In diesem Beispiel wird überprüft, ob der Benutzer ein 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 der My.User.IsInRole Methode kann Ihr Code ermitteln, ob der aktuelle Benutzer Mitglied der angegebenen Rolle ist.

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

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

Note

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

Verfügbarkeit nach Projekttyp

Projekttyp Available
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

Boolean

Truewenn der aktuelle Benutzer Mitglied der angegebenen Rolle ist; andernfalls . False

Beispiele

In diesem Beispiel wird überprüft, ob der Benutzer ein 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 der My.User.IsInRole Methode kann Ihr Code ermitteln, ob der aktuelle Benutzer Mitglied der angegebenen Rolle ist.

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

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

Note

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

Verfügbarkeit nach Projekttyp

Projekttyp Available
Windows-Anwendung Ja
Klassenbibliothek Ja
Konsolenanwendung Ja
Windows-Steuerelementbibliothek Ja
Websteuerelementbibliothek Ja
Windows-Dienst Ja
Website Ja

Weitere Informationen

Gilt für: