SqlServices Klasa

Definicja

Przestrzeń nazw:

System.Web.Management

Zestaw:

System.Web.dll

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

public ref class SqlServices abstract sealed

public static class SqlServices

type SqlServices = class

Public Class SqlServices

Dziedziczenie

Object

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

Bazy danych programu SQL Server umożliwiają przechowywanie informacji dotyczących 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 programu SQL Server, z którą są połączone, została prawidłowo skonfigurowana przed użyciem. Aby to zrobić, możesz użyć narzędzia ASP.NET Register SQL (aspnet_regsql.exe) 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 wybranych usług ASP.NET w bazie danych programu SQL Server.
Install(String, String, SqlFeatures)	Instaluje składniki dla wybranych funkcji ASP.NET w bazie danych programu SQL Server.
Install(String, String, String, String, SqlFeatures)	Instaluje składniki dla wybranych funkcji ASP.NET w bazie danych programu SQL Server.
InstallSessionState(String, SessionStateType, String)	Instaluje składniki stanu sesji ASP.NET w bazie danych programu SQL Server.
InstallSessionState(String, String, SessionStateType)	Instaluje składniki stanu sesji ASP.NET w bazie danych programu SQL Server.
InstallSessionState(String, String, String, String, SessionStateType)	Instaluje składniki stanu sesji ASP.NET w bazie danych programu SQL Server.
Uninstall(String, SqlFeatures, String)	Usuwa składniki wybranych funkcji ASP.NET z bazy danych programu SQL Server.
Uninstall(String, String, SqlFeatures)	Usuwa składniki wybranych funkcji ASP.NET z bazy danych programu SQL Server.
Uninstall(String, String, String, String, SqlFeatures)	Usuwa składniki wybranych funkcji ASP.NET z bazy danych programu SQL Server.
UninstallSessionState(String, SessionStateType, String)	Usuwa składniki stanu sesji ASP.NET z bazy danych programu SQL Server.
UninstallSessionState(String, String, SessionStateType)	Usuwa składniki stanu sesji ASP.NET z bazy danych programu SQL Server.
UninstallSessionState(String, String, String, String, SessionStateType)	Usuwa składniki stanu sesji ASP.NET z bazy danych programu SQL Server.

Zobacz też

• Instalowanie bazy danych dostawcy programu SQL Server
• Tryby stanu sesji