SqlServices クラス

リファレンス

定義

名前空間:: System.Web.Management

アセンブリ:: System.Web.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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 Register 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 データベースから削除します。

適用対象

SqlServices クラス

定義

例

注釈

メソッド

適用対象

こちらもご覧ください

その他のリソース