WebService.User Eigenschaft

Definition

Namespace:

System.Web.Services

Assembly:

System.Web.Services.dll

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.

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

Eigenschaftswert

IPrincipal

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

Attribute

BrowsableAttribute

Beispiele

Das folgende Beispiel sucht den authentifizierten Benutzernamen und gibt diesen Namen zurück.

<%@ 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 (IIS) als auch .NET Framework müssen für die Authentifizierung konfiguriert werden, damit die User Eigenschaft sinnvoll ist. Authentifizierung ist der Prozess, bei dem Anmeldeinformationen von einem Benutzer akzeptiert und diese Anmeldeinformationen bei einer Autorität überprüft werden. Wenn die Anmeldeinformationen gültig sind, verfügen Sie über eine authentifizierte Identität. Die Authentifizierung in .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.

Weitere Informationen

• IPrincipal
• Sichern von mit ASP.NET erstellten XML-Webdiensten