SqlServices Clase

Referencia

Definición

Espacio de nombres:: System.Web.Management

Ensamblado:: System.Web.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Permite instalar y quitar los elementos de base de datos de SQL Server de las características de ASP.NET.

public ref class SqlServices abstract sealed

public static class SqlServices

type SqlServices = class

Public Class SqlServices

Herencia: Object
SqlServices

Ejemplos

En el ejemplo de código siguiente se muestra cómo se utiliza la clase 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

Comentarios

Puede usar SQL Server bases de datos para almacenar información para ASP.NET características como el estado de sesión, la pertenencia, la personalización de elementos web y la administración de roles. Estas características requieren que la base de datos SQL Server a la que están conectadas esté configurada correctamente antes de su uso. Puede usar la herramienta ASP.NET Registrar SQL (aspnet_regsql.exe) para hacerlo, o bien puede llamar a los métodos estáticos expuestos por la clase directamente desde el SqlServices código.

Nota

Con la herramienta aspnet_regsql.exe o la SqlServices clase para configurar la base de datos solo configura la base de datos que los proveedores usarán con las tablas, desencadenadores y procedimientos almacenados adecuados. La configuración de la base de datos de esta manera no modifica los archivos de configuración para especificar que estas características usan los proveedores de SQL para estos servicios.

Métodos

GenerateApplicationServicesScripts(Boolean, SqlFeatures, String)	Genera scripts SQL para las características seleccionadas. Los scripts harán referencia a la base de datos indicada por el parámetro de base de datos.
GenerateSessionStateScripts(Boolean, SessionStateType, String)	Genera el script SQL para instalar o quitar el estado de sesión. El script hará referencia a la base de datos indicada por el parámetro de base de datos.
Install(String, SqlFeatures, String)	Instala los componentes para los servicios de ASP.NET seleccionados en una base de datos de SQL Server.
Install(String, String, SqlFeatures)	Instala los componentes para las características de ASP.NET seleccionadas en una base de datos de SQL Server.
Install(String, String, String, String, SqlFeatures)	Instala los componentes para las características de ASP.NET seleccionadas en una base de datos de SQL Server.
InstallSessionState(String, SessionStateType, String)	Instala los componentes para el estado de sesión de ASP.NET en una base de datos de SQL Server.
InstallSessionState(String, String, SessionStateType)	Instala los componentes para el estado de sesión de ASP.NET en una base de datos de SQL Server.
InstallSessionState(String, String, String, String, SessionStateType)	Instala los componentes para el estado de sesión de ASP.NET en una base de datos de SQL Server.
Uninstall(String, SqlFeatures, String)	Quita los componentes para las características de ASP.NET seleccionadas de una base de datos de SQL Server.
Uninstall(String, String, SqlFeatures)	Quita los componentes para las características de ASP.NET seleccionadas de una base de datos de SQL Server.
Uninstall(String, String, String, String, SqlFeatures)	Quita los componentes para las características de ASP.NET seleccionadas de una base de datos de SQL Server.
UninstallSessionState(String, SessionStateType, String)	Quita los componentes para el estado de sesión de ASP.NET de una base de datos de SQL Server.
UninstallSessionState(String, String, SessionStateType)	Quita los componentes para el estado de sesión de ASP.NET de una base de datos de SQL Server.
UninstallSessionState(String, String, String, String, SessionStateType)	Quita los componentes para el estado de sesión de ASP.NET de una base de datos de SQL Server.

Se aplica a