SqlServices Klasa

Definicja

Obsługuje instalowanie i usuwanie elementów bazy danych SQL Server funkcji ASP.NET.

public ref class SqlServices abstract sealed
public static class SqlServices
type SqlServices = class
Public Class SqlServices
Dziedziczenie
SqlServices

Przykłady

W poniższym przykładzie kodu pokazano, jak używać SqlServices klasy.

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

Uwagi

Za pomocą baz danych SQL Server można przechowywać informacje dotyczące funkcji ASP.NET, takich jak stan sesji, członkostwo, personalizacja składników Web Part i zarządzanie rolami. Te funkcje wymagają, aby baza danych SQL Server, z którą są połączone, została prawidłowo skonfigurowana przed użyciem. Możesz użyć narzędzia ASP.NET Register SQL (aspnet_regsql.exe), aby to zrobić, lub wywołać metody statyczne uwidocznione przez klasę SqlServices bezpośrednio z poziomu kodu.

Uwaga

Za pomocą narzędzia aspnet_regsql.exe lub SqlServices klasy do skonfigurowania bazy danych konfiguruje tylko bazę danych, która będzie używana przez dostawców z odpowiednimi tabelami, wyzwalaczami i procedurami składowanymi. Skonfigurowanie bazy danych w ten sposób nie modyfikuje plików konfiguracji w celu określenia, że te funkcje używają dostawców SQL dla tych usług.

Metody

GenerateApplicationServicesScripts(Boolean, SqlFeatures, String)

Generuje skrypty SQL dla wybranych funkcji. Skrypty będą odwoływać się do bazy danych wskazanej przez parametr bazy danych.

GenerateSessionStateScripts(Boolean, SessionStateType, String)

Generuje skrypt SQL do instalowania lub usuwania stanu sesji. Skrypt odwołuje się do bazy danych wskazanej przez parametr bazy danych.

Install(String, SqlFeatures, String)

Instaluje składniki dla wybranych usług ASP.NET w bazie danych SQL Server.

Install(String, String, SqlFeatures)

Instaluje składniki dla wybranych funkcji ASP.NET w bazie danych SQL Server.

Install(String, String, String, String, SqlFeatures)

Instaluje składniki dla wybranych funkcji ASP.NET w bazie danych SQL Server.

InstallSessionState(String, SessionStateType, String)

Instaluje składniki stanu sesji ASP.NET w bazie danych SQL Server.

InstallSessionState(String, String, SessionStateType)

Instaluje składniki stanu sesji ASP.NET w bazie danych SQL Server.

InstallSessionState(String, String, String, String, SessionStateType)

Instaluje składniki stanu sesji ASP.NET w bazie danych SQL Server.

Uninstall(String, SqlFeatures, String)

Usuwa składniki wybranych funkcji ASP.NET z bazy danych SQL Server.

Uninstall(String, String, SqlFeatures)

Usuwa składniki wybranych funkcji ASP.NET z bazy danych SQL Server.

Uninstall(String, String, String, String, SqlFeatures)

Usuwa składniki wybranych funkcji ASP.NET z bazy danych SQL Server.

UninstallSessionState(String, SessionStateType, String)

Usuwa składniki stanu sesji ASP.NET z bazy danych SQL Server.

UninstallSessionState(String, String, SessionStateType)

Usuwa składniki stanu sesji ASP.NET z bazy danych SQL Server.

UninstallSessionState(String, String, String, String, SessionStateType)

Usuwa składniki stanu sesji ASP.NET z bazy danych SQL Server.

Dotyczy

Zobacz też