WebService.User Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft das ASP.NET Serverobjekt User ab. Kann verwendet werden, um zu authentifizieren, ob ein Benutzer berechtigt ist, die Anforderung auszuführen.
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.IPrincipalPublic ReadOnly Property User As IPrincipalEigenschaftswert
A IPrincipal representing the ASP.NET server User object.
- Attribute
Beispiele
Im folgenden Beispiel wird der authentifizierte Benutzername nachschlagen und dieser Name zurückgegeben.
<%@ 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
Hinweise
Sowohl Internetinformationsdienste (INTERNET Information Services, IIS) als auch .NET Framework müssen für die Authentifizierung konfiguriert werden, damit die User Eigenschaft sinnvoll ist. Die Authentifizierung ist der Vorgang des Akzeptierens von Anmeldeinformationen von einem Benutzer und das Überprüfen dieser Anmeldeinformationen für einige Autoritäten. Wenn die Anmeldeinformationen gültig sind, verfügen Sie über eine authentifizierte Identität. Die Authentifizierung im .NET Framework wird konfiguriert, indem Einträge in der web.config Datei platziert werden.
Im folgenden Beispiel werden die Einträge veranschaulicht, die Sie in der web.config-Datei platzieren, um die Windows-Authentifizierung zu aktivieren.
<security>
<authentication mode="Windows"> <!-- Mode Options are Windows, Cookie, Passport and None or Empty String -->
</authentication>
</security>
Weitere Informationen zum Einrichten der Sicherheit für einen XML-Webdienst finden Sie unter Sichern von XML-Webdiensten, die mit ASP.NET erstellt wurden.
