WebService.User Eigenschaft

Referenz

Definition

Namespace:: System.Web.Services

Assembly:: System.Web.Services.dll

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 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.

Gilt für:

Freigeben über