WebService.User-Eigenschaft

Ruft das User-Objekt des ASP.NET-Servers ab. Kann verwendet werden, um zu authentifizieren, ob ein Benutzer zum Ausführen der Anforderung berechtigt ist.

Namespace: System.Web.Services
Assembly: System.Web.Services (in system.web.services.dll)

Syntax

'Declaration
Public ReadOnly Property User As IPrincipal
'Usage
Dim instance As WebService
Dim value As IPrincipal

value = instance.User

public IPrincipal User { get; }

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

/** @property */
public IPrincipal get_User ()

public function get User () : IPrincipal

Eigenschaftenwert

Ein IPrincipal, der das User-Objekt des ASP.NET-Servers darstellt.

Hinweise

Sowohl IIS (Internet Information Services, Internetinformationsdienste) als auch .NET Framework müssen für die Authentifizierung konfiguriert werden, damit die User-Eigenschaft sinnvoll ist. Authentifizierung ist das Annehmen der Anmeldeinformationen eines Benutzers und die Überprüfung dieser Informationen durch eine berechtigte Instanz. Wenn die Anmeldeinformationen gültig sind, verfügen Sie über eine authentifizierte Identität. Die Authentifizierung in .NET Framework wird durch Einfügen von Einträgen in der Datei web.config konfiguriert.

Das folgende Beispiel demonstriert, welche Einträge in die Datei web.config eingefügt werden müssen, 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 mit ASP.NET erstellten XML-Webdiensten.

Beispiel

Im folgenden Beispiel wird der authentifizierte Benutzername gesucht und zurückgegeben.

<%@ 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
    

<%@ 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;
      }
 }
    

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

WebService-Klasse
WebService-Member
System.Web.Services-Namespace
IPrincipal

Weitere Ressourcen

Sichern von mit ASP.NET erstellten XML-Webdiensten