SqlServices Класс

Определение

Пространство имен:

System.Web.Management

Сборка:

System.Web.dll

Поддерживает установку и удаление элементов базы данных SQL Server функций ASP.NET.

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 базы данных для хранения информации для 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.

См. также раздел

• Установка базы данных поставщика SQL Server
• Режимы состояния сеанса