SqlServices Klasse

Referenz

Definition

Namespace:: System.Web.Management

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Unterstützt das Installieren und Entfernen der SQL Server-Datenbankelemente von ASP.NET-Features.

public ref class SqlServices abstract sealed

public static class SqlServices

type SqlServices = class

Public Class SqlServices

Vererbung: Object
SqlServices

Beispiele

Im folgenden Codebeispiel wird die Verwendung der SqlServices-Klasse veranschaulicht.

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

Hinweise

Sie können SQL Server-Datenbanken verwenden, um Informationen für ASP.NET Features wie Sitzungsstatus, Mitgliedschaft, Webpartspersonalisierung und Rollenverwaltung zu speichern. Diese Features erfordern, dass die SQL Server-Datenbank, mit der sie verbunden sind, vor der Verwendung ordnungsgemäß konfiguriert wird. Dazu können Sie das ASP.NET Sql-Registertool (aspnet_regsql.exe) verwenden, oder Sie können die statischen Methoden, die von der SqlServices -Klasse verfügbar gemacht werden, direkt aus Ihrem Code aufrufen.

Hinweis

Wenn Sie das aspnet_regsql.exe tool oder die SqlServices -Klasse verwenden, um die Datenbank zu konfigurieren, wird nur die Datenbank eingerichtet, die von den Anbietern mit den richtigen Tabellen, Triggern und gespeicherten Prozeduren verwendet wird. Wenn Sie die Datenbank auf diese Weise konfigurieren, werden konfigurationsdateien nicht geändert, um anzugeben, dass diese Features die SQL-Anbieter für diese Dienste verwenden.

Methoden

GenerateApplicationServicesScripts(Boolean, SqlFeatures, String)	Generiert die SQL-Skripts für die ausgewählten Features. Die Skripts verweisen auf die vom Datenbankparameter angegebene Datenbank.
GenerateSessionStateScripts(Boolean, SessionStateType, String)	Generiert das SQL-Skript zum Installieren oder Entfernen des Sitzungszustands. Das Skript verweist auf die vom Datenbankparameter angegebene Datenbank.
Install(String, SqlFeatures, String)	Installiert Komponenten für ausgewählte ASP.NET-Dienste in einer SQL Server-Datenbank.
Install(String, String, SqlFeatures)	Installiert Komponenten für ausgewählte ASP.NET-Features in einer SQL Server-Datenbank.
Install(String, String, String, String, SqlFeatures)	Installiert Komponenten für ausgewählte ASP.NET-Features in einer SQL Server-Datenbank.
InstallSessionState(String, SessionStateType, String)	Installiert Komponenten für den ASP.NET-Sitzungszustand in einer SQL Server-Datenbank.
InstallSessionState(String, String, SessionStateType)	Installiert Komponenten für den ASP.NET-Sitzungszustand in einer SQL Server-Datenbank.
InstallSessionState(String, String, String, String, SessionStateType)	Installiert Komponenten für den ASP.NET-Sitzungszustand in einer SQL Server-Datenbank.
Uninstall(String, SqlFeatures, String)	Entfernt Komponenten für die ausgewählten ASP.NET-Features aus einer SQL Server-Datenbank.
Uninstall(String, String, SqlFeatures)	Entfernt Komponenten für die ausgewählten ASP.NET-Features aus einer SQL Server-Datenbank.
Uninstall(String, String, String, String, SqlFeatures)	Entfernt Komponenten für die ausgewählten ASP.NET-Features aus einer SQL Server-Datenbank.
UninstallSessionState(String, SessionStateType, String)	Entfernt Komponenten für den ASP.NET-Sitzungszustand aus einer SQL Server-Datenbank.
UninstallSessionState(String, String, SessionStateType)	Entfernt Komponenten für den ASP.NET-Sitzungszustand aus einer SQL Server-Datenbank.
UninstallSessionState(String, String, String, String, SessionStateType)	Entfernt Komponenten für den ASP.NET-Sitzungszustand aus einer SQL Server-Datenbank.

Gilt für:

Freigeben über