SqlCeEngine 클래스

SQL Server Compact Engine 개체의 속성, 메서드 및 기타 개체를 나타냅니다. 이 클래스는 상속될 수 없습니다.

상속 계층

System.Object
  System.Data.SqlServerCe.SqlCeEngine

네임스페이스:  System.Data.SqlServerCe
어셈블리:  System.Data.SqlServerCe(System.Data.SqlServerCe.dll)

구문

‘선언
Public NotInheritable Class SqlCeEngine _
    Implements IDisposable
‘사용 방법
Dim instance As SqlCeEngine

public sealed class SqlCeEngine : IDisposable

public ref class SqlCeEngine sealed : IDisposable

[<SealedAttribute>]
type SqlCeEngine =  
    class
        interface IDisposable
    end

public final class SqlCeEngine implements IDisposable

SqlCeEngine 유형에서 다음 멤버를 표시합니다.

생성자

	이름	설명
	SqlCeEngine()	SqlCeEngine 클래스의 새 인스턴스를 초기화합니다.
	SqlCeEngine(String)	지정된 로컬 연결 문자열을 사용하여 SqlCeEngine 클래스의 새 인스턴스를 초기화합니다.

맨 위로 이동

속성

	이름	설명
	LocalConnectionString	SQL Server Compact 데이터베이스의 연결 문자열을 가져오거나 설정합니다.

맨 위로 이동

메서드

	이름	설명
	Compact	기존 파일로부터 새 데이터베이스 파일을 만드는 방식으로 SQL Server Compact 데이터베이스의 불필요한 공간을 회수합니다. 이 메서드는 또한 데이터베이스의 데이터 정렬 순서, 암호화 또는 암호 설정을 변경하는 데 사용됩니다.
	CreateDatabase	새 데이터베이스를 만듭니다.
	Dispose	모든 SQL Server Compact SqlCeEngine 리소스를 해제합니다.
	Equals	(Object에서 상속)
	Finalize	(Object에서 상속)
	GetHashCode	(Object에서 상속)
	GetType	(Object에서 상속)
	MemberwiseClone	(Object에서 상속)
	Repair	손상된 데이터베이스를 복구합니다.
	Shrink	빈 페이지를 파일 끝으로 이동하고 파일을 자르는 방식으로 SQL Server Compact 데이터베이스의 불필요한 공간을 회수합니다.
	ToString	(Object에서 상속)
	Upgrade()	SQL Server Compact 데이터베이스 3.5를 4.0으로 업그레이드합니다. 업그레이드한 이후 원본 데이터베이스가 암호화되면 이 업그레이드된 데이터베이스도 암호화됩니다. 반대로 원본 데이터베이스가 암호화되지 않으면 업그레이드된 데이터베이스도 암호화되지 않습니다.
	Upgrade(String)	SQL Server Compact 데이터베이스 3.5를 4.0으로 업그레이드합니다. 암호화 모드가 대상 연결 문자열에 지정되어 있으면 대상 데이터베이스가 암호화됩니다. 연결 문자열에서 대/소문자 구분 속성이 true로 설정되어 있으면 데이터베이스의 데이터 정렬이 대/소문자를 구분합니다.
	Verify()	데이터베이스의 각 페이지에 대한 체크섬을 다시 계산하고 새 체크섬을 예상 값과 비교합니다.
	Verify(VerifyOption)	VerifyOption에 따라 데이터베이스의 무결성을 확인합니다.

맨 위로 이동

주의

SQL Server Compact은 웹 사이트 및 웹 응용 프로그램용 데이터베이스로 사용하도록 최적화되어 있습니다. SQL Server Compact은 웹 응용 프로그램 내에서 포함된 데이터베이스로 사용하도록 최적화되어 있습니다. SQL Server Compact는 웹 사이트에서 여러 사용자 및 동시 데이터베이스 변경을 위한 데이터베이스로 사용할 수 있습니다.

SQL Server Compact은 ASP.NET 웹 응용 프로그램을 개발하는 데 사용할 수 있습니다. 이전 버전의 SQL Server Compact에서는 ASP.NET 웹 응용 프로그램에서 SQL Server Compact을 사용하기 위해 SQLServerCompactEditionUnderWebHosting 플래그를 설정해야 했습니다. SQL Server Compact 4.0에서는 이 플래그가 제거되었습니다.

예

다음 예제에서는 새 SQL Server Compact 데이터베이스를 만드는 방법을 보여 줍니다.

If File.Exists("Test.sdf") Then
   File.Delete("Test.sdf")
End If 
Dim connStr As String = "Data Source = Test.sdf; Password = <password>"

Dim engine As New SqlCeEngine(connStr)
engine.CreateDatabase()
engine.Dispose()

Dim conn As SqlCeConnection = Nothing

Try
   conn = New SqlCeConnection(connStr)
   conn.Open()

   Dim cmd As SqlCeCommand = conn.CreateCommand()
   cmd.CommandText = "CREATE TABLE myTable (col1 int, col2 ntext)"
   cmd.ExecuteNonQuery()
Catch
Finally
   conn.Close()
End Try

if (File.Exists("Test.sdf"))
    File.Delete("Test.sdf");

string connStr = "Data Source = Test.sdf; Password = <password>";

SqlCeEngine engine = new SqlCeEngine(connStr);
engine.CreateDatabase();
engine.Dispose();

SqlCeConnection conn = null;

try {
    conn = new SqlCeConnection(connStr);
    conn.Open();

    SqlCeCommand cmd = conn.CreateCommand();
    cmd.CommandText = "CREATE TABLE myTable (col1 int, col2 ntext)";
    cmd.ExecuteNonQuery();
}
catch {}
finally {
    conn.Close();
}

스레드 보안

이 형식의 모든 public static(Microsoft Visual Basic의 경우 Shared) 멤버는 스레드로부터 안전합니다. 인스턴스 멤버는 스레드로부터의 안전성이 보장되지 않습니다.

참고 항목

참조

System.Data.SqlServerCe 네임스페이스