SqlServices Classe

Definição

Dá suporte à instalação e remoção dos elementos do banco de dados do SQL Server de recursos ASP.NET.

public ref class SqlServices abstract sealed
public static class SqlServices
type SqlServices = class
Public Class SqlServices
Herança
SqlServices

Exemplos

O exemplo de código a seguir mostra como usar a SqlServices classe .

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

Comentários

Você pode usar bancos de dados do SQL Server para armazenar informações para ASP.NET recursos como estado da sessão, associação, personalização de Web parts e gerenciamento de função. Esses recursos exigem que o banco de dados do SQL Server ao qual eles estão conectados seja configurado corretamente antes do uso. Você pode usar a ferramenta ASP.NET Registrar SQL (aspnet_regsql.exe) para fazer isso ou chamar os métodos estáticos expostos pela SqlServices classe diretamente do código.

Observação

Usar a ferramenta aspnet_regsql.exe ou a SqlServices classe para configurar o banco de dados configura apenas o banco de dados que os provedores usarão com as tabelas, gatilhos e procedimentos armazenados adequados. A configuração do banco de dados dessa forma não modifica os arquivos de configuração para especificar que esses recursos usam os Provedores de SQL para esses serviços.

Métodos

GenerateApplicationServicesScripts(Boolean, SqlFeatures, String)

Gera os scripts SQL para os recursos selecionados. Os scripts referenciarão o banco de dados indicado pelo parâmetro de banco de dados.

GenerateSessionStateScripts(Boolean, SessionStateType, String)

Gera o script SQL para instalar ou remover o estado de sessão. O script referenciará o banco de dados indicado pelo parâmetro de banco de dados.

Install(String, SqlFeatures, String)

Instala componentes para serviços ASP.NET selecionados em um banco de dados do SQL Server.

Install(String, String, SqlFeatures)

Instala componentes para recursos ASP.NET selecionados em um banco de dados do SQL Server.

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

Instala componentes para recursos ASP.NET selecionados em um banco de dados do SQL Server.

InstallSessionState(String, SessionStateType, String)

Instala componentes para o estado de sessão ASP.NET em um banco de dados do SQL Server.

InstallSessionState(String, String, SessionStateType)

Instala componentes para o estado de sessão ASP.NET em um banco de dados do SQL Server.

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

Instala componentes para o estado de sessão ASP.NET em um banco de dados do SQL Server.

Uninstall(String, SqlFeatures, String)

Remove componentes para recursos ASP.NET selecionados de um banco de dados do SQL Server.

Uninstall(String, String, SqlFeatures)

Remove componentes para recursos ASP.NET selecionados de um banco de dados do SQL Server.

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

Remove componentes para recursos ASP.NET selecionados de um banco de dados do SQL Server.

UninstallSessionState(String, SessionStateType, String)

Remove componentes para o estado de sessão ASP.NET de um banco de dados do SQL Server.

UninstallSessionState(String, String, SessionStateType)

Remove componentes para o estado de sessão ASP.NET de um banco de dados do SQL Server.

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

Remove componentes para o estado de sessão ASP.NET de um banco de dados do SQL Server.

Aplica-se a

Confira também