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

Определение

Определяет, принадлежит ли текущий пользователь указанной роли.Determines whether the current user belongs to the specified role.

Перегрузки

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

Определяет, принадлежит ли текущий пользователь указанной роли.Determines whether the current user belongs to the specified role.

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

Определяет, принадлежит ли текущий пользователь указанной роли.Determines whether the current user belongs to the specified role.

IsInRole(BuiltInRole) IsInRole(BuiltInRole) IsInRole(BuiltInRole) 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 BuiltInRole BuiltInRole BuiltInRole

Встроенная роль Windows, для которой требуется проверить членство.The built-in Windows role for which to check membership.

Возвраты

Значение True, если текущий пользователь является членом указанной роли; в противном случае — значение False.True 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.

Перегрузка My.User.IsInRole метода, который BuiltInRole принимает перечисление, ведет себя по-разному в зависимости от текущего участника.The overload of the My.User.IsInRole method that takes a BuiltInRole enumeration behaves differently, depending on the current principal. Если это субъект-WindowsPrincipalпользователь Windows (), эта функция преобразует role в эквивалентное WindowsBuiltInRole перечисление и возвращает результат вызова метода 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
Приложение WindowsWindows Application ДаYes
Библиотека классовClass Library ДаYes
Консольное приложениеConsole Application ДаYes
Библиотека элементов управления WindowsWindows Control Library ДаYes
Библиотека веб-элементов управленияWeb Control Library ДаYes
Служба WindowsWindows Service ДаYes
Веб-сайтWeb Site ДаYes

Безопасность

SecurityPermission
Описывает набор разрешений безопасности, применяемых к коду.Describes a set of security permissions applied to code. Связанное перечисление: ControlPrincipal.Associated enumeration: ControlPrincipal.

Дополнительно

IsInRole(String) IsInRole(String) IsInRole(String) 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 String String String

Имя роли, для которой требуется проверить членство.The name of the role for which to check membership.

Возвраты

Значение True, если текущий пользователь является членом указанной роли; в противном случае — значение False.True 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.

Перегрузка My.User.IsInRole метода, который BuiltInRole принимает перечисление, ведет себя по-разному в зависимости от текущего участника.The overload of the My.User.IsInRole method that takes a BuiltInRole enumeration behaves differently, depending on the current principal. Если это субъект-WindowsPrincipalпользователь Windows (), эта функция преобразует role в эквивалентное WindowsBuiltInRole перечисление и возвращает результат вызова метода 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
Приложение WindowsWindows Application ДаYes
Библиотека классовClass Library ДаYes
Консольное приложениеConsole Application ДаYes
Библиотека элементов управления WindowsWindows Control Library ДаYes
Библиотека веб-элементов управленияWeb Control Library ДаYes
Служба WindowsWindows Service ДаYes
Веб-сайтWeb Site ДаYes

Безопасность

SecurityPermission
Описывает набор разрешений безопасности, применяемых к коду.Describes a set of security permissions applied to code. Связанное перечисление: ControlPrincipal.Associated enumeration: ControlPrincipal.

Дополнительно

Применяется к