SqlServices Classe

Riferimento

Definizione

Spazio dei nomi:: System.Web.Management

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Supporta l'installazione e la rimozione di elementi di database SQL Server delle funzionalità ASP.NET.

public ref class SqlServices abstract sealed

public static class SqlServices

type SqlServices = class

Public Class SqlServices

Ereditarietà: Object
SqlServices

Esempio

Nell'esempio di codice seguente viene illustrato l'utilizzo della classe 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

Commenti

È possibile usare SQL Server database per archiviare le informazioni per ASP.NET funzionalità quali lo stato della sessione, l'appartenenza, la personalizzazione delle web part e la gestione dei ruoli. Queste funzionalità richiedono che il database SQL Server a cui sono connessi siano configurati correttamente prima dell'uso. È possibile usare lo strumento SQL Register ASP.NET (aspnet_regsql.exe) per eseguire questa operazione oppure è possibile chiamare i metodi statici esposti dalla SqlServices classe direttamente dal codice.

Nota

Usando lo strumento aspnet_regsql.exe o la SqlServices classe per configurare il database configura solo il database che i provider useranno con le tabelle, i trigger e le stored procedure appropriate. La configurazione del database in questo modo non modifica i file di configurazione per specificare che queste funzionalità usano i provider di SQL per questi servizi.

Metodi

GenerateApplicationServicesScripts(Boolean, SqlFeatures, String)	Genera gli script SQL per le funzionalità selezionate. Gli script faranno riferimento al database indicato dall'apposito parametro.
GenerateSessionStateScripts(Boolean, SessionStateType, String)	Genera lo script SQL per l'installazione o la rimozione dello stato sessione. Lo script farà riferimento al database indicato dall'apposito parametro.
Install(String, SqlFeatures, String)	Installa i componenti per i servizi ASP.NET selezionati in un database SQL Server.
Install(String, String, SqlFeatures)	Installa i componenti per le funzionalità ASP.NET selezionate in un database SQL Server.
Install(String, String, String, String, SqlFeatures)	Installa i componenti per le funzionalità ASP.NET selezionate in un database SQL Server.
InstallSessionState(String, SessionStateType, String)	Installa i componenti per lo stato sessione di ASP.NET in un database SQL Server.
InstallSessionState(String, String, SessionStateType)	Installa i componenti per lo stato sessione di ASP.NET in un database SQL Server.
InstallSessionState(String, String, String, String, SessionStateType)	Installa i componenti per lo stato sessione di ASP.NET in un database SQL Server.
Uninstall(String, SqlFeatures, String)	Rimuove i componenti per le funzionalità ASP.NET selezionate da un database SQL Server.
Uninstall(String, String, SqlFeatures)	Rimuove i componenti per le funzionalità ASP.NET selezionate da un database SQL Server.
Uninstall(String, String, String, String, SqlFeatures)	Rimuove i componenti per le funzionalità ASP.NET selezionate da un database SQL Server.
UninstallSessionState(String, SessionStateType, String)	Rimuove i componenti per lo stato sessione di ASP.NET da un database SQL Server.
UninstallSessionState(String, String, SessionStateType)	Rimuove i componenti per lo stato sessione di ASP.NET da un database SQL Server.
UninstallSessionState(String, String, String, String, SessionStateType)	Rimuove i componenti per lo stato sessione di ASP.NET da un database SQL Server.

Si applica a