SqlServices Třída

Definice

Obor názvů:

System.Web.Management

Sestavení:

System.Web.dll

Podporuje instalaci a odebrání databázových prvků SQL Serveru ASP.NET funkcí.

public ref class SqlServices abstract sealed

public static class SqlServices

type SqlServices = class

Public Class SqlServices

Dědičnost

Object

SqlServices

Příklady

Následující příklad kódu ukazuje, jak používat SqlServices třídu.

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

Poznámky

Databáze SQL Serveru můžete použít k ukládání informací pro ASP.NET funkce, jako je stav relace, členství, přizpůsobení webových částí a správa rolí. Tyto funkce vyžadují, aby databáze SQL Serveru, ke které jsou připojeny, byla před použitím správně nakonfigurovaná. K tomu můžete použít nástroj ASP.NET Register SQL (aspnet_regsql.exe) nebo můžete volat statické metody vystavené SqlServices třídou přímo z vašeho kódu.

Poznámka

Pomocí nástroje aspnet_regsql.exe nebo SqlServices třídy ke konfiguraci databáze se nastaví pouze databáze, kterou budou poskytovatelé používat se správnými tabulkami, triggery a uloženými procedurami. Konfigurace databáze tímto způsobem neupravuje konfigurační soubory, aby bylo možné určit, že tyto funkce používají zprostředkovatele SQL pro tyto služby.

Metody

GenerateApplicationServicesScripts(Boolean, SqlFeatures, String)	Vygeneruje skripty SQL pro vybrané funkce. Skripty budou odkazovat na databázi označenou parametrem databáze.
GenerateSessionStateScripts(Boolean, SessionStateType, String)	Vygeneruje skript SQL pro instalaci nebo odebrání stavu relace. Skript bude odkazovat na databázi označenou parametrem databáze.
Install(String, SqlFeatures, String)	Nainstaluje komponenty pro vybrané ASP.NET služby do databáze SQL Serveru.
Install(String, String, SqlFeatures)	Nainstaluje komponenty pro vybrané funkce ASP.NET do databáze SQL Serveru.
Install(String, String, String, String, SqlFeatures)	Nainstaluje komponenty pro vybrané funkce ASP.NET do databáze SQL Serveru.
InstallSessionState(String, SessionStateType, String)	Nainstaluje komponenty pro ASP.NET stav relace v databázi SQL Serveru.
InstallSessionState(String, String, SessionStateType)	Nainstaluje komponenty pro ASP.NET stav relace v databázi SQL Serveru.
InstallSessionState(String, String, String, String, SessionStateType)	Nainstaluje komponenty pro ASP.NET stav relace v databázi SQL Serveru.
Uninstall(String, SqlFeatures, String)	Odebere komponenty pro vybrané funkce ASP.NET z databáze SQL Serveru.
Uninstall(String, String, SqlFeatures)	Odebere komponenty pro vybrané funkce ASP.NET z databáze SQL Serveru.
Uninstall(String, String, String, String, SqlFeatures)	Odebere komponenty pro vybrané funkce ASP.NET z databáze SQL Serveru.
UninstallSessionState(String, SessionStateType, String)	Odebere komponenty pro ASP.NET stavu relace z databáze SQL Serveru.
UninstallSessionState(String, String, SessionStateType)	Odebere komponenty pro ASP.NET stavu relace z databáze SQL Serveru.
UninstallSessionState(String, String, String, String, SessionStateType)	Odebere komponenty pro ASP.NET stavu relace z databáze SQL Serveru.

Viz také

• Instalace databáze zprostředkovatele SQL Serveru
• Režimy stavu relace