SqlServices クラス

定義

名前空間:

System.Web.Management

アセンブリ:

System.Web.dll

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

public ref class SqlServices abstract sealed

public static class SqlServices

type SqlServices = class

Public Class SqlServices

継承

Object

SqlServices

例

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

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=<user name>, password=<secure password>";
string user = "AspAdmin";
string password = "Secure Password"; // Use a sicure password.

// 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);
            }
        }
    }
}

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=<user name>, password=<secure password>"
Dim user As String = "AspAdmin"
Dim password As String = "Secure Password"

' 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

注釈

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

注意

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

メソッド

GenerateApplicationServicesScripts(Boolean, SqlFeatures, String)	選択した機能の SQL スクリプトを生成します。 生成されたスクリプトは、データベース パラメーターで指定されているデータベースを参照します。
GenerateSessionStateScripts(Boolean, SessionStateType, String)	セッション状態をインストールまたは削除する SQL スクリプトを生成します。 生成されたスクリプトは、データベース パラメーターで指定されているデータベースを参照します。
Install(String, SqlFeatures, String)	選択した ASP.NET サービスのコンポーネントを SQL Server データベースにインストールします。
Install(String, String, SqlFeatures)	選択した ASP.NET 機能のコンポーネントを SQL Server データベースにインストールします。
Install(String, String, String, String, SqlFeatures)	選択した ASP.NET 機能のコンポーネントを SQL Server データベースにインストールします。
InstallSessionState(String, SessionStateType, String)	ASP.NET セッション状態のコンポーネントを SQL Server データベースにインストールします。
InstallSessionState(String, String, SessionStateType)	ASP.NET セッション状態のコンポーネントを SQL Server データベースにインストールします。
InstallSessionState(String, String, String, String, SessionStateType)	ASP.NET セッション状態のコンポーネントを SQL Server データベースにインストールします。
Uninstall(String, SqlFeatures, String)	選択した ASP.NET 機能のコンポーネントを SQL Server データベースから削除します。
Uninstall(String, String, SqlFeatures)	選択した ASP.NET 機能のコンポーネントを SQL Server データベースから削除します。
Uninstall(String, String, String, String, SqlFeatures)	選択した ASP.NET 機能のコンポーネントを SQL Server データベースから削除します。
UninstallSessionState(String, SessionStateType, String)	ASP.NET セッション状態のコンポーネントを SQL Server データベースから削除します。
UninstallSessionState(String, String, SessionStateType)	ASP.NET セッション状態のコンポーネントを SQL Server データベースから削除します。
UninstallSessionState(String, String, String, String, SessionStateType)	ASP.NET セッション状態のコンポーネントを SQL Server データベースから削除します。

こちらもご覧ください

• SQL Server プロバイダー データベースのインストール
• セッション状態モード