WebService.User Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
Uma IPrincipal que representa o objeto User do servidor ASP.NET.
- Atributos
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.