FormsAuthenticationUserCollection クラス

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

FormsAuthenticationUserCollection クラス

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

FormsAuthenticationUser オブジェクトのコレクションを表します。このクラスは継承できません。

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

Visual Basic (宣言)

Public NotInheritable Class
 FormsAuthenticationUserCollection
    Inherits ConfigurationElementCollection

Visual Basic (使用法)

Dim instance As FormsAuthenticationUserCollection

C#

public sealed class FormsAuthenticationUserCollection
 : ConfigurationElementCollection

C++

public ref class FormsAuthenticationUserCollection
 sealed : public ConfigurationElementCollection

J#

public final class FormsAuthenticationUserCollection
 extends ConfigurationElementCollection

JScript

public final class FormsAuthenticationUserCollection
 extends ConfigurationElementCollection

解説

FormsAuthenticationCredentials は FormsAuthenticationUserCollection を使用して、authorization 構成セクションの forms セクション内の credentials セクションの users 要素にプログラムからアクセスして変更できます。

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

使用例

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

メモ
credentials 要素を使用する場合は、「ASP.NET の認証」に説明されているガイドラインに従う必要があります。スケーラビリティとセキュリティを高めるため、外部のデータベースを使用して、ユーザーの資格情報を保管することをお勧めします。安全な ASP.NET アプリケーションを構築する方法の詳細については、Microsoft MSDN Web サイト (msdn.microsoft.com) で、「Securing Your ASP.NET Application」や「Building Secure ASP.NET Applications: Authentication, Authorization, and Secure Communication」を参照してください。

Visual Basic

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

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

' Get the forms credentials collection .
  Dim formsAuthenticationCredentials _
  As FormsAuthenticationCredentials = _
  authenticationSection.Forms.Credentials

C#

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

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

// Get the forms credentials collection .
FormsAuthenticationCredentials formsAuthenticationCredentials =
    authenticationSection.Forms.Credentials;

継承階層

System.Object
   System.Configuration.ConfigurationElement
     System.Configuration.ConfigurationElementCollection
      System.Web.Configuration.FormsAuthenticationUserCollection

スレッド セーフ

この型の 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

参照

関連項目
FormsAuthenticationUserCollection メンバ
System.Web.Configuration 名前空間
その他の技術情報
authentication 要素 (ASP.NET 設定スキーマ)
authentication の forms 要素 (ASP.NET 設定スキーマ)
ASP.NET の認証
フォーム認証資格情報
フォーム認証プロバイダ
アプリケーション間のフォーム認証