SqlServices Classe

Référence

Définition

Espace de noms:: System.Web.Management

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Prend en charge l'installation et la suppression des éléments de base de données SQL Server des fonctionnalités ASP.NET.

public ref class SqlServices abstract sealed

public static class SqlServices

type SqlServices = class

Public Class SqlServices

Héritage: Object
SqlServices

Exemples

L'exemple de code suivant montre comment utiliser la 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

Remarques

Vous pouvez utiliser SQL Server bases de données pour stocker des informations pour ASP.NET fonctionnalités telles que l’état de session, l’appartenance, la personnalisation des composants WebPart et la gestion des rôles. Ces fonctionnalités nécessitent que la base de données SQL Server à laquelle elles sont connectées soit correctement configurée avant l’utilisation. Vous pouvez utiliser l’outil ASP.NET Register SQL (aspnet_regsql.exe) pour ce faire, ou vous pouvez appeler les méthodes statiques exposées par la SqlServices classe directement à partir de votre code.

Notes

L’utilisation de l’outil aspnet_regsql.exe ou de la SqlServices classe pour configurer la base de données configure uniquement la base de données que les fournisseurs utiliseront avec les tables, déclencheurs et procédures stockées appropriées. La configuration de la base de données de cette façon ne modifie pas les fichiers de configuration pour spécifier que ces fonctionnalités utilisent les fournisseurs SQL pour ces services.

Méthodes

GenerateApplicationServicesScripts(Boolean, SqlFeatures, String)	Génère les scripts SQL pour les fonctionnalités sélectionnées. Les scripts référenceront la base de données indiquée par le paramètre de base de données.
GenerateSessionStateScripts(Boolean, SessionStateType, String)	Génère le script SQL pour l'installation ou la suppression de l'état de session. Le script référencera la base de données indiquée par le paramètre de base de données.
Install(String, SqlFeatures, String)	Installe des composants pour les services ASP.NET sélectionnés sur une base de données SQL Server.
Install(String, String, SqlFeatures)	Installe des composants pour les fonctionnalités ASP.NET sélectionnées sur une base de données SQL Server.
Install(String, String, String, String, SqlFeatures)	Installe des composants pour les fonctionnalités ASP.NET sélectionnées sur une base de données SQL Server.
InstallSessionState(String, SessionStateType, String)	Installe des composants pour l'état de session ASP.NET sur une base de données SQL Server.
InstallSessionState(String, String, SessionStateType)	Installe des composants pour l'état de session ASP.NET sur une base de données SQL Server.
InstallSessionState(String, String, String, String, SessionStateType)	Installe des composants pour l'état de session ASP.NET sur une base de données SQL Server.
Uninstall(String, SqlFeatures, String)	Supprime d'une base de données SQL Server des composants de fonctionnalités ASP.NET sélectionnées.
Uninstall(String, String, SqlFeatures)	Supprime d'une base de données SQL Server des composants de fonctionnalités ASP.NET sélectionnées.
Uninstall(String, String, String, String, SqlFeatures)	Supprime d'une base de données SQL Server des composants de fonctionnalités ASP.NET sélectionnées.
UninstallSessionState(String, SessionStateType, String)	Supprime d'une base de données SQL Server des composants de l'état de session ASP.NET.
UninstallSessionState(String, String, SessionStateType)	Supprime d'une base de données SQL Server des composants de l'état de session ASP.NET.
UninstallSessionState(String, String, String, String, SessionStateType)	Supprime d'une base de données SQL Server des composants de l'état de session ASP.NET.

S’applique à