SqlServices Kelas

Definisi

Ruang nama:

System.Web.Management

Rakitan:

System.Web.dll

Mendukung penginstalan dan penghapusan elemen database SQL Server dari fitur ASP.NET.

public ref class SqlServices abstract sealed

public static class SqlServices

type SqlServices = class

Public Class SqlServices

Warisan

Object

SqlServices

Contoh

Contoh kode berikut menunjukkan cara menggunakan SqlServices kelas .

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

Keterangan

Anda dapat menggunakan database SQL Server untuk menyimpan informasi untuk fitur ASP.NET seperti status sesi, keanggotaan, personalisasi bagian Web, dan manajemen peran. Fitur-fitur ini mengharuskan database SQL Server yang terhubung dikonfigurasi dengan benar sebelum digunakan. Anda dapat menggunakan alat ASP.NET Register SQL (aspnet_regsql.exe) untuk melakukan ini, atau Anda dapat memanggil metode statis yang diekspos oleh SqlServices kelas langsung dari kode Anda.

Catatan

Menggunakan alat aspnet_regsql.exe atau SqlServices kelas untuk mengonfigurasi database hanya menyiapkan database yang akan digunakan penyedia dengan tabel, pemicu, dan prosedur tersimpan yang tepat. Mengonfigurasi database dengan cara ini tidak mengubah file konfigurasi untuk menentukan bahwa fitur-fitur ini menggunakan Penyedia SQL untuk layanan ini.

Metode

GenerateApplicationServicesScripts(Boolean, SqlFeatures, String)	Menghasilkan skrip SQL untuk fitur yang dipilih. Skrip akan mereferensikan database yang ditunjukkan oleh parameter database.
GenerateSessionStateScripts(Boolean, SessionStateType, String)	Menghasilkan skrip SQL untuk menginstal atau menghapus status sesi. Skrip akan mereferensikan database yang ditunjukkan oleh parameter database.
Install(String, SqlFeatures, String)	Menginstal komponen untuk layanan ASP.NET yang dipilih pada database SQL Server.
Install(String, String, SqlFeatures)	Menginstal komponen untuk fitur ASP.NET yang dipilih pada database SQL Server.
Install(String, String, String, String, SqlFeatures)	Menginstal komponen untuk fitur ASP.NET yang dipilih pada database SQL Server.
InstallSessionState(String, SessionStateType, String)	Menginstal komponen untuk status sesi ASP.NET pada database SQL Server.
InstallSessionState(String, String, SessionStateType)	Menginstal komponen untuk status sesi ASP.NET pada database SQL Server.
InstallSessionState(String, String, String, String, SessionStateType)	Menginstal komponen untuk status sesi ASP.NET pada database SQL Server.
Uninstall(String, SqlFeatures, String)	Menghapus komponen untuk fitur ASP.NET yang dipilih dari database SQL Server.
Uninstall(String, String, SqlFeatures)	Menghapus komponen untuk fitur ASP.NET yang dipilih dari database SQL Server.
Uninstall(String, String, String, String, SqlFeatures)	Menghapus komponen untuk fitur ASP.NET yang dipilih dari database SQL Server.
UninstallSessionState(String, SessionStateType, String)	Menghapus komponen untuk status sesi ASP.NET dari database SQL Server.
UninstallSessionState(String, String, SessionStateType)	Menghapus komponen untuk status sesi ASP.NET dari database SQL Server.
UninstallSessionState(String, String, String, String, SessionStateType)	Menghapus komponen untuk status sesi ASP.NET dari database SQL Server.

Lihat juga

• Menginstal Database Penyedia SQL Server
• Mode Status Sesi