SqlServices

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

SqlServices クラス

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

ASP.NET 機能の SQL Server データベース要素のインストールおよび削除をサポートします。

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

Visual Basic (宣言)

Public NotInheritable Class
 SqlServices

Visual Basic (使用法)

静的クラスのメンバは、クラスのインスタンスなしに直接アクセスされます。

C#

public static class SqlServices

C++

public ref class SqlServices abstract sealed

J#

public final class SqlServices

JScript

public final class SqlServices

解説

SQL Server データベースを使用して、セッション状態、メンバシップ、Web パーツのパーソナル化、ロール管理などの ASP.NET 機能の情報を格納できます。これらの機能を使用するには、接続先となる SQL Server データベースが前もって適切に構成されている必要があります。構成するには、ASP.NET Register SQL ツール (aspnet_regsql.exe) を使用するか、SqlServices クラスが公開している静的メソッドをコードから直接呼び出します。

メモ
データベースの構成に aspnet_regsql.exe ツールまたは SqlServices クラスを使用すると、プロバイダで適切なテーブル、トリガ、およびストアド プロシージャと共に使用されるデータベースだけがセットアップされます。この方法でデータベースを構成しても、これらの機能が各サービスで SQL プロバイダを使用するよう構成ファイルが変更されることはありません。

使用例

SqlServices クラスを使用するコード例を次に示します。

Visual Basic

Imports System
Imports System.Web.Management

Module UsingSqlServices
    Sub Main()
        Try
' Values to use.
Dim server As String = "ASPFeatureServer"
Dim database As String =
 "ASPFeatureDB"
Dim connectionString As String
 = _
    "server=ASPFeatureServer, pooling=False, user=AspAdmin, password=Secret"
Dim user As String = "AspAdmin"
Dim password As String =
 "Secret"

' Install membership and personalization.
SqlServices.Install(database, _
    SqlFeatures.Membership And _
    SqlFeatures.Personalization, _
    connectionString)

' Remove membership and personalization.
SqlServices.Uninstall(database, _
    SqlFeatures.Membership And _
    SqlFeatures.Personalization, _
    connectionString)

' Install all features.
SqlServices.Install(server, database, _
    SqlFeatures.All)

' Remove all features.
SqlServices.Uninstall(server, database, _
    SqlFeatures.All)

' Install a custom session state database.
SqlServices.InstallSessionState(database, _
    SessionStateType.Custom, _
    connectionString)

' Remove a custom session state database.
SqlServices.UninstallSessionState(database, _
    SessionStateType.Custom, _
    connectionString)

' Install temporary session state.
SqlServices.InstallSessionState(server, Nothing, _
    SessionStateType.Temporary)

' Remove temporary session state.
SqlServices.UninstallSessionState(server, Nothing, _
    SessionStateType.Temporary)

' Install persisted session state.
SqlServices.InstallSessionState(server, user, password, _
    Nothing, SessionStateType.Persisted)

' Remove persisted session state.
SqlServices.UninstallSessionState(server, user, password, _
    Nothing, SessionStateType.Persisted)
        Catch sqlExecutionException As SqlExecutionException
Console.WriteLine( _
    "An SQL execution exception occurred.")
Console.WriteLine()
Console.WriteLine("  Message: {0}", _
    sqlExecutionException.Message)
Console.WriteLine("  Server: {0}", _
    sqlExecutionException.Server)
Console.WriteLine("  Database: {0}", _
    sqlExecutionException.Database)
Console.WriteLine("  Commands: {0}", _
    sqlExecutionException.Commands)
Console.WriteLine("  SqlFile: {0}", _
    sqlExecutionException.SqlFile)
Console.WriteLine("  Inner Exception: {0}", _
    sqlExecutionException.Exception)
        Catch ex As Exception
Console.WriteLine("An unknown exception occurred.")
Console.WriteLine()
Console.WriteLine("  Message: {0}", ex.Message)
        End Try
    End Sub
End Module

C#

using System;
using System.Web.Management;

namespace UsingSQLServices
{
    class UsingSqlServices
    {
        static void Main(string[]
 args)
        {
            try
            {
// Values to use.
string server = "ASPFeatureServer";
string database = "ASPFeatureDB";
string connectionString =
    "server=ASPFeatureServer, pooling=False, user=AspAdmin, password=Secret";
string user = "AspAdmin";
string password = "Secret";

// Install membership and personalization.
SqlServices.Install(database,
    SqlFeatures.Membership &
    SqlFeatures.Personalization,
    connectionString);

// Remove membership and personalization.
SqlServices.Uninstall(database,
    SqlFeatures.Membership &
    SqlFeatures.Personalization,
    connectionString);

// Install all features.
SqlServices.Install(server, database,
    SqlFeatures.All);

// Remove all features.
SqlServices.Uninstall(server, database,
    SqlFeatures.All);

// Install a custom session state database.
SqlServices.InstallSessionState(database,
    SessionStateType.Custom,
    connectionString);

// Remove a custom session state database.
SqlServices.UninstallSessionState(database,
    SessionStateType.Custom,
    connectionString);

// Install temporary session state.
SqlServices.InstallSessionState(server, null,
    SessionStateType.Temporary);

// Remove temporary session state.
SqlServices.UninstallSessionState(server, null,
    SessionStateType.Temporary);

// Install persisted session state.
SqlServices.InstallSessionState(server, user, password,
    null, SessionStateType.Persisted);

// Remove persisted session state.
SqlServices.UninstallSessionState(server, user, password,
    null, SessionStateType.Persisted);
            }
            catch (SqlExecutionException sqlExecutionException)
            {
Console.WriteLine(
    "An SQL execution exception occurred.");
Console.WriteLine();
Console.WriteLine("  Message: {0}",
    sqlExecutionException.Message);
Console.WriteLine("  Server: {0}",
    sqlExecutionException.Server);
Console.WriteLine("  Database: {0}",
    sqlExecutionException.Database);
Console.WriteLine("  Commands: {0}",
    sqlExecutionException.Commands);
Console.WriteLine("  SqlFile: {0}",
    sqlExecutionException.SqlFile);
Console.WriteLine("  Inner Exception: {0}",
    sqlExecutionException.Exception);
            }
            catch (Exception ex)
            {
Console.WriteLine("An unknown exception occurred.");
Console.WriteLine();
Console.WriteLine("  Message: {0}", ex.Message);
            }
        }
    }
}

.NET Framework のセキュリティ

• AspNetHostingPermission  ホスト環境での動作に必要なアクセス許可。要求値 : LinkDemand; アクセス許可値 : High。

継承階層

System.Object
  System.Web.Management.SqlServices

スレッド セーフ

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

プラットフォーム

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

参照

関連項目
SqlServices メンバ
System.Web.Management 名前空間
その他の技術情報
SQL Server 向けアプリケーション サービス データベースの作成
セッション状態モード

SqlServices メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GenerateApplicationServicesScripts	選択した機能の SQL スクリプトを生成します。生成されたスクリプトは、データベース パラメータで指定されているデータベースを参照します。
	GenerateSessionStateScripts	セッション状態をインストールまたは削除する SQL スクリプトを生成します。生成されたスクリプトは、データベース パラメータで指定されているデータベースを参照します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	Install	オーバーロードされます。 指定した ASP.NET 機能のコンポーネントを SQL Server データベースにインストールします。
	InstallSessionState	オーバーロードされます。 ASP.NET セッション状態のコンポーネントを SQL Server データベースにインストールします。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)
	Uninstall	オーバーロードされます。 選択した ASP.NET 機能のコンポーネントを SQL Server データベースから削除します。
	UninstallSessionState	オーバーロードされます。 ASP.NET セッション状態のコンポーネントを SQL Server データベースから削除します。

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

SqlServices クラス
System.Web.Management 名前空間

その他の技術情報

SQL Server 向けアプリケーション サービス データベースの作成
セッション状態モード

SqlServices メンバ

ASP.NET 機能の SQL Server データベース要素のインストールおよび削除をサポートします。

SqlServices データ型で公開されるメンバを以下の表に示します。

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GenerateApplicationServicesScripts	選択した機能の SQL スクリプトを生成します。生成されたスクリプトは、データベース パラメータで指定されているデータベースを参照します。
	GenerateSessionStateScripts	セッション状態をインストールまたは削除する SQL スクリプトを生成します。生成されたスクリプトは、データベース パラメータで指定されているデータベースを参照します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	Install	オーバーロードされます。 指定した ASP.NET 機能のコンポーネントを SQL Server データベースにインストールします。
	InstallSessionState	オーバーロードされます。 ASP.NET セッション状態のコンポーネントを SQL Server データベースにインストールします。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)
	Uninstall	オーバーロードされます。 選択した ASP.NET 機能のコンポーネントを SQL Server データベースから削除します。
	UninstallSessionState	オーバーロードされます。 ASP.NET セッション状態のコンポーネントを SQL Server データベースから削除します。

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

SqlServices クラス
System.Web.Management 名前空間

その他の技術情報

SQL Server 向けアプリケーション サービス データベースの作成
セッション状態モード