Condividi tramite


SqlServices Classe

Definizione

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à
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 i database di SQL Server per archiviare 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 di SQL Server a cui sono connesse sia configurato correttamente prima dell'uso. A tale scopo, è possibile usare lo strumento ASP.NET Register SQL (aspnet_regsql.exe) oppure 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 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

Vedi anche