SqlServices Classe

Referência

Definição

Namespace:: System.Web.Management

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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: Object
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 SQL Server bancos de dados para armazenar informações para recursos de ASP.NET, como estado de sessão, associação, personalização de Web Parts e gerenciamento de funções. Esses recursos exigem que o banco de dados 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. Configurar o 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

Compartilhar via