WebService.User Propriedade

Definição

Namespace:

System.Web.Services

Assembly:

System.Web.Services.dll

Obtém o objeto User do servidor ASP.NET. Pode ser usado para autenticar se um usuário está autorizado a executar a solicitação.

public:
 property System::Security::Principal::IPrincipal ^ User { System::Security::Principal::IPrincipal ^ get(); };

[System.ComponentModel.Browsable(false)]
public System.Security.Principal.IPrincipal User { get; }

[<System.ComponentModel.Browsable(false)>]
member this.User : System.Security.Principal.IPrincipal

Public ReadOnly Property User As IPrincipal

Valor da propriedade

IPrincipal

Uma IPrincipal que representa o objeto User do servidor ASP.NET.

Atributos

BrowsableAttribute

Exemplos

O exemplo a seguir pesquisa o nome de usuário autenticado e retorna esse nome.

<%@ WebService Language="C#" Class="Util" %>
 
 using System.Web.Services;
 
 public class Util: WebService {
      [ WebMethod(Description="Obtains the User Name",EnableSession=false) ]
      public string GetUserName() {
         return User.Identity.Name;
      }
 }

<%@ WebService Language="VB" Class="Util" %>
 
Imports System.Web.Services

Public Class Util
    Inherits WebService
    
    <WebMethod(Description := "Obtains the User Name", _
        EnableSession := False)> _
    Public Function GetUserName() As String
        
        Return User.Identity.Name
    End Function
End Class

Comentários

Os Serviços de Informações da Internet (IIS) e o .NET Framework precisam ser configurados para autenticação para que a User propriedade seja significativa. A autenticação é o processo de aceitar credenciais de um usuário e validar essas credenciais em relação a alguma autoridade. Se as credenciais forem válidas, você terá uma identidade autenticada. A autenticação no .NET Framework é configurada colocando entradas no arquivo web.config.

O exemplo a seguir demonstra as entradas que você coloca no arquivo web.config para habilitar a autenticação do Windows.

<security>  
 <authentication mode="Windows"> <!-- Mode Options are Windows, Cookie, Passport and None or Empty String -->  
 </authentication>  
 </security>  

Para obter mais informações sobre como configurar a segurança de um serviço Web XML, consulte Protegendo serviços Web XML criados usando ASP.NET.

Confira também

• IPrincipal
• Protegendo XML Web Services criados usando ASP.NET