SqlServices Třída

Definice

Obor názvů:

System.Web.Management

Sestavení:

System.Web.dll

Podporuje instalaci a odebrání prvků databáze SQL Server funkcí ASP.NET.

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 Server 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 se před použitím správně nakonfigurovala databáze SQL Server, ke které jsou připojené. 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 kódu.

Poznámka

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

Metody

GenerateApplicationServicesScripts(Boolean, SqlFeatures, String)	Vygeneruje SQL skripty 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é služby ASP.NET do databáze SQL Server.
Install(String, String, SqlFeatures)	Nainstaluje komponenty pro vybrané funkce ASP.NET do databáze SQL Server.
Install(String, String, String, String, SqlFeatures)	Nainstaluje komponenty pro vybrané funkce ASP.NET do databáze SQL Server.
InstallSessionState(String, SessionStateType, String)	Nainstaluje komponenty pro stav relace ASP.NET do databáze SQL Server.
InstallSessionState(String, String, SessionStateType)	Nainstaluje komponenty pro stav relace ASP.NET do databáze SQL Server.
InstallSessionState(String, String, String, String, SessionStateType)	Nainstaluje komponenty pro stav relace ASP.NET do databáze SQL Server.
Uninstall(String, SqlFeatures, String)	Odebere součásti pro vybrané funkce ASP.NET z databáze SQL Server.
Uninstall(String, String, SqlFeatures)	Odebere součásti pro vybrané funkce ASP.NET z databáze SQL Server.
Uninstall(String, String, String, String, SqlFeatures)	Odebere součásti pro vybrané funkce ASP.NET z databáze SQL Server.
UninstallSessionState(String, SessionStateType, String)	Odebere součásti pro stav relace ASP.NET z databáze SQL Server.
UninstallSessionState(String, String, SessionStateType)	Odebere součásti pro stav relace ASP.NET z databáze SQL Server.
UninstallSessionState(String, String, String, String, SessionStateType)	Odebere součásti pro stav relace ASP.NET z databáze SQL Server.

Viz také

• Instalace databáze poskytovatele SQL Server
• Režimy stavu relace