PassportAuthentication クラス

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

PassportAuthentication クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

ASP.NET アプリケーションで Passport ベース認証を構成します。

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

Visual Basic (宣言)

Public NotInheritable Class
 PassportAuthentication
    Inherits ConfigurationElement

Visual Basic (使用法)

Dim instance As PassportAuthentication

C#

public sealed class PassportAuthentication
 : ConfigurationElement

C++

public ref class PassportAuthentication sealed
 : public ConfigurationElement

J#

public final class PassportAuthentication extends
 ConfigurationElement

JScript

public final class PassportAuthentication extends
 ConfigurationElement

解説

PassportAuthentication クラスを使用すると、passport タグで識別される Machine.config 構成ファイルまたは Web.config 構成ファイルのノードにアクセスして構成できます。

この型は、AuthenticationSection 型、FormsAuthenticationConfiguration 型、AuthenticationMode 型を含むグループの一部です。

メモ
PassportAuthentication クラスは、マシン レベル、サイト レベル、またはアプリケーション レベルのみで、構成ファイルの関連するセクションに情報を書き込むことができます。階層構造内の別のレベルで構成ファイルに書き込みを行おうとした場合、パーサーによってエラー メッセージが生成されます。このクラスを使用して、階層構造の任意のレベルの構成情報を読み取ることができます。

使用例

既存の Web アプリケーションの構成ファイルから PassportAuthentication オブジェクトを取得する方法を次のコード例に示します。構成の例も示します。

<authentication>
  <passport redirectUrl="Login.aspx"/>
</authentication>

Visual Basic

' Get the configuration.
Dim configuration As System.Configuration.Configuration
 = System.Web.Configuration.WebConfigurationManager.OpenWebConfiguration("/aspnetTest")

' Get the authentication section.
Dim authenticationSection As System.Web.Configuration.AuthenticationSection
 = CType(configuration.GetSection("system.web/authentication"),
 System.Web.Configuration.AuthenticationSection)

' Get the authentication passport element.
Dim passport As PassportAuthentication = authenticationSection.Passport

C#

// Get the configuration.
// Get the Web application configuration.
System.Configuration.Configuration configuration = System.Web.Configuration.WebConfigurationManager.OpenWebConfiguration("/aspnetTest");

// Get the section.
System.Web.Configuration.AuthenticationSection authenticationSection = (System.Web.Configuration.AuthenticationSection)configuration.GetSection("system.web/authentication");

// Get the authentication passport element.
PassportAuthentication passport = authenticationSection.Passport;

継承階層

System.Object
   System.Configuration.ConfigurationElement
    System.Web.Configuration.PassportAuthentication

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, 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

参照

関連項目
PassportAuthentication メンバ
System.Web.Configuration 名前空間
AuthenticationSection クラス
その他の技術情報
ASP.NET の認証
方法 : ASP.NET アプリケーションに Passport 認証を実装する
Windows 認証またはパスポート認証を使用したメンバシップの比較
Passport 認証プロバイダ