WebService.User プロパティ

ASP.NET サーバーの User オブジェクトを取得します。要求を実行する権限がユーザーに与えられているかどうかを認証するために使用できます。

Public ReadOnly Property User As IPrincipal
[C#]
public IPrincipal User {get;}
[C++]
public: __property IPrincipal* get_User();
[JScript]
public function get User() : IPrincipal;

プロパティ値

ASP.NET サーバーの User オブジェクトを表す IPrincipal 。

解説

User プロパティを使用するには、IIS (Internet Information Services) と .NET Framework を両方とも認証を行うように構成する必要があります。認証とは、ユーザーの資格情報を取得し、それらの資格情報を認証機関で検証する処理のことです。資格情報が有効な場合、そのユーザーには認証済みの ID があります。.NET Framework での認証は、web.config ファイルにエントリを追加することによって構成します。

web.config ファイルにエントリを追加し、Windows 認証を有効にする例を次に示します。

<security>
 <authentication mode="Windows"> <!-- Mode Options are Windows, Cookie, Passport and None or Empty String -->
 </authentication>
 </security>
   

XML Web サービスのセキュリティ設定の詳細については、「 ASP.NET を使用して作成した XML Web サービスのセキュリティ 」を参照してください。

使用例

[Visual Basic, C#] 認証されたユーザー名を検索し、その名前を返す例を次に示します。

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

[C#] 
<%@ 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;
      }
 }
    

[C++, JScript] C++ および JScript のサンプルはありません。Visual Basic および C# のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

参照

WebService クラス | WebService メンバ | System.Web.Services 名前空間 | IPrincipal | ASP.NET を使用して作成した XML Web サービスのセキュリティ