SqlServices Sınıf

Başvuru

Tanım

Ad Alanı:: System.Web.Management

Bütünleştirilmiş Kod:: System.Web.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

ASP.NET özelliklerin SQL Server veritabanı öğelerinin yüklenmesini ve kaldırılmasını destekler.

public ref class SqlServices abstract sealed

public static class SqlServices

type SqlServices = class

Public Class SqlServices

Devralma: Object
SqlServices

Örnekler

Aşağıdaki kod örneği sınıfının nasıl kullanılacağını SqlServices gösterir.

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

Açıklamalar

Oturum durumu, üyelik, Web bölümlerini kişiselleştirme ve rol yönetimi gibi ASP.NET özelliklerine ilişkin bilgileri depolamak için SQL Server veritabanlarını kullanabilirsiniz. Bu özellikler, bağlandıkları SQL Server veritabanının kullanılmadan önce düzgün yapılandırılmasını gerektirir. Bunu yapmak için ASP.NET Register SQL aracını (aspnet_regsql.exe) kullanabilir veya doğrudan kodunuzdan sınıfın SqlServices kullanıma sunduğu statik yöntemleri çağırabilirsiniz.

Not

veritabanını yapılandırmak için aspnet_regsql.exe aracını veya SqlServices sınıfını kullanarak yalnızca sağlayıcıların uygun tablolarla, tetikleyicilerle ve saklı yordamlarla kullanacağı veritabanını ayarlar. Veritabanını bu şekilde yapılandırmak, yapılandırma dosyalarını değiştirerek bu özelliklerin bu hizmetler için SQL Sağlayıcılarını kullandığını belirtmez.

Yöntemler

GenerateApplicationServicesScripts(Boolean, SqlFeatures, String)	Seçili özellikler için SQL betikleri oluşturur. Betikler, veritabanı parametresi tarafından belirtilen veritabanına başvurur.
GenerateSessionStateScripts(Boolean, SessionStateType, String)	Oturum durumunu yüklemek veya kaldırmak için SQL betiğini oluşturur. Betik, veritabanı parametresi tarafından belirtilen veritabanına başvurur.
Install(String, SqlFeatures, String)	Seçilen ASP.NET hizmetlerinin bileşenlerini SQL Server veritabanına yükler.
Install(String, String, SqlFeatures)	Seçilen ASP.NET özelliklerinin bileşenlerini SQL Server veritabanına yükler.
Install(String, String, String, String, SqlFeatures)	Seçilen ASP.NET özelliklerinin bileşenlerini SQL Server veritabanına yükler.
InstallSessionState(String, SessionStateType, String)	SQL Server veritabanına ASP.NET oturum durumu için bileşenleri yükler.
InstallSessionState(String, String, SessionStateType)	SQL Server veritabanına ASP.NET oturum durumu için bileşenleri yükler.
InstallSessionState(String, String, String, String, SessionStateType)	SQL Server veritabanına ASP.NET oturum durumu için bileşenleri yükler.
Uninstall(String, SqlFeatures, String)	Seçili ASP.NET özelliklerinin bileşenlerini bir SQL Server veritabanından kaldırır.
Uninstall(String, String, SqlFeatures)	Seçili ASP.NET özelliklerinin bileşenlerini bir SQL Server veritabanından kaldırır.
Uninstall(String, String, String, String, SqlFeatures)	Seçili ASP.NET özelliklerinin bileşenlerini bir SQL Server veritabanından kaldırır.
UninstallSessionState(String, SessionStateType, String)	SQL Server veritabanından ASP.NET oturum durumu bileşenlerini kaldırır.
UninstallSessionState(String, String, SessionStateType)	SQL Server veritabanından ASP.NET oturum durumu bileşenlerini kaldırır.
UninstallSessionState(String, String, String, String, SessionStateType)	SQL Server veritabanından ASP.NET oturum durumu bileşenlerini kaldırır.

Şunlara uygulanır