WebService.User プロパティ

.NET Framework クラス ライブラリ リファレンス

WebService.User プロパティ

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

名前空間: System.Web.Services
アセンブリ: System.Web.Services (system.web.services.dll 内)
構文

Visual Basic (宣言)

Public ReadOnly Property
 User As IPrincipal

Visual Basic (使用法)

Dim instance As WebService
Dim value As IPrincipal

value = instance.User

C#

public IPrincipal User { get; }

C++

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

J#

/** @property */
public 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

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

プラットフォーム

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
WebService クラス
WebService メンバ
System.Web.Services 名前空間
IPrincipal
その他の技術情報
ASP.NET を使用して作成した XML Web サービスのセキュリティ