SqlServices 类

定义

支持安装和移除 ASP.NET 功能的 SQL Server 数据库元素。

public ref class SqlServices abstract sealed
public static class SqlServices
type SqlServices = class
Public Class SqlServices
继承
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数据库来存储 ASP.NET 功能的信息,例如会话状态、成员身份、Web 部件个性化和角色管理。 这些功能要求在使用前正确配置连接它们的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)

在 SQL Server 数据库上安装选定 ASP.NET 服务的组件。

Install(String, String, SqlFeatures)

在 SQL Server 数据库上安装选定 ASP.NET 功能的组件。

Install(String, String, String, String, SqlFeatures)

在 SQL Server 数据库上安装选定 ASP.NET 功能的组件。

InstallSessionState(String, SessionStateType, String)

在 SQL Server 数据库上安装 ASP.NET 会话状态的组件。

InstallSessionState(String, String, SessionStateType)

在 SQL Server 数据库上安装 ASP.NET 会话状态的组件。

InstallSessionState(String, String, String, String, SessionStateType)

在 SQL Server 数据库上安装 ASP.NET 会话状态的组件。

Uninstall(String, SqlFeatures, String)

从 SQL Server 数据库中移除选定 ASP.NET 功能的组件。

Uninstall(String, String, SqlFeatures)

从 SQL Server 数据库中移除选定 ASP.NET 功能的组件。

Uninstall(String, String, String, String, SqlFeatures)

从 SQL Server 数据库中移除选定 ASP.NET 功能的组件。

UninstallSessionState(String, SessionStateType, String)

从 SQL Server 数据库中移除 ASP.NET 会话状态的组件。

UninstallSessionState(String, String, SessionStateType)

从 SQL Server 数据库中移除 ASP.NET 会话状态的组件。

UninstallSessionState(String, String, String, String, SessionStateType)

从 SQL Server 数据库中移除 ASP.NET 会话状态的组件。

适用于

另请参阅