SqlCeConnection 클래스

SQL Server Compact 데이터 원본에 대해 열려 있는 연결을 나타냅니다.

상속 계층

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      System.Data.Common.DbConnection
        System.Data.SqlServerCe.SqlCeConnection

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

구문

‘선언
Public NotInheritable Class SqlCeConnection _
    Inherits DbConnection
‘사용 방법
Dim instance As SqlCeConnection

public sealed class SqlCeConnection : DbConnection

public ref class SqlCeConnection sealed : public DbConnection

[<SealedAttribute>]
type SqlCeConnection =  
    class
        inherit DbConnection
    end

public final class SqlCeConnection extends DbConnection

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

생성자

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

맨 위로 이동

속성

	이름	설명
	CanRaiseEvents	(Component에서 상속)
	ConnectionString	데이터베이스를 여는 데 사용되는 문자열을 가져오거나 설정합니다. (DbConnection.ConnectionString을(를) 재정의함)
	ConnectionTimeout	연결 설정을 시도할 때 시도를 종료하고 오류를 생성하기 전까지의 대기 시간을 가져옵니다. (DbConnection.ConnectionTimeout을(를) 재정의함)
	Container	(Component에서 상속)
	Database	현재 데이터베이스 이름이나 연결되었을 때 사용할 데이터베이스의 이름을 가져옵니다. (DbConnection.Database을(를) 재정의함)
	DatabaseIdentifier	동기화하는 동안 현재 데이터베이스의 고유 식별자를 가져옵니다.
	DataSource	데이터 원본의 파일 이름을 가져옵니다. (DbConnection.DataSource을(를) 재정의함)
	DbProviderFactory	(DbConnection에서 상속)
	DesignMode	(Component에서 상속)
	Events	(Component에서 상속)
	ServerVersion	데이터베이스 버전 번호를 문자열로 반환합니다. (DbConnection.ServerVersion을(를) 재정의함)
	Site	(Component에서 상속)
	State	연결의 현재 상태를 가져옵니다. (DbConnection.State을(를) 재정의함)

맨 위로 이동

메서드

	이름	설명
	BeginDbTransaction	(DbConnection에서 상속)
	BeginTransaction()	데이터베이스 트랜잭션을 시작합니다.
	BeginTransaction(IsolationLevel)	현재 IsolationLevel 값을 사용하여 데이터베이스 트랜잭션을 시작합니다.
	ChangeDatabase	열려 있는 SqlCeConnection의 현재 데이터베이스를 변경합니다. (DbConnection.ChangeDatabase(String)을(를) 재정의함)
	Close	데이터 원본에 대한 연결을 닫습니다. 이것은 열려 있는 연결을 닫는 기본 설정 메서드입니다. (DbConnection.Close()을(를) 재정의함)
	CreateCommand	SqlCeConnection 과 관련된 SqlCeCommand 개체를 만들고 반환합니다.
	CreateDbCommand	(DbConnection에서 상속)
	CreateObjRef	(MarshalByRefObject에서 상속)
	Dispose()	SqlCeConnection 클래스의 현재 인스턴스에서 사용하는 리소스를 모두 해제합니다.
	Dispose(Boolean)	(Component에서 상속)
	EnlistTransaction(Transaction)	(DbConnection에서 상속)
	EnlistTransaction(Transaction)	지정된 Transaction에 참여합니다.
	Equals	(Object에서 상속)
	Finalize	(Component에서 상속)
	GetDatabaseInfo	연결된 데이터베이스의 로캘, 암호화 모드 및 대/소문자 구분 설정에 대한 정보와 함께 키 값 쌍의 집합을 반환합니다.
	GetHashCode	(Object에서 상속)
	GetLifetimeService	(MarshalByRefObject에서 상속)
	GetSchema()	이 SqlCeConnection의 데이터 원본에 대한 스키마 정보를 반환합니다. (DbConnection.GetSchema()을(를) 재정의함)
	GetSchema(String)	스키마 이름의 지정된 문자열을 사용하여 이 SqlCeConnection의 데이터 원본에 대한 스키마 정보를 반환합니다. (DbConnection.GetSchema(String)을(를) 재정의함)
	GetSchema(String, array<String[])	스키마 이름의 지정된 문자열과 제한 값의 지정된 문자열 배열을 사용하여 이 SqlCeConnection의 데이터 원본에 대한 스키마 정보를 반환합니다. (DbConnection.GetSchema(String, array<String[])을(를) 재정의함)
	GetService	(Component에서 상속)
	GetType	(Object에서 상속)
	InitializeLifetimeService	(MarshalByRefObject에서 상속)
	MemberwiseClone()	(Object에서 상속)
	MemberwiseClone(Boolean)	(MarshalByRefObject에서 상속)
	OnStateChange	(DbConnection에서 상속)
	Open	ConnectionString 이 지정하는 속성 설정을 사용하여 데이터베이스 연결을 엽니다. (DbConnection.Open()을(를) 재정의함)
	ToString	(Component에서 상속)

맨 위로 이동

이벤트

	이름	설명
	Disposed	(Component에서 상속)
	FlushFailure	백그라운드 플러시가 실패하면 발생합니다.
	InfoMessage	.NET Compact Framework Data Provider for SQL Server가 경고 또는 정보 메시지를 보내면 발생합니다.
	StateChange	연결 상태가 변경되면 발생합니다. (DbConnection.StateChange을(를) 재정의함)

맨 위로 이동

명시적 인터페이스 구현

	이름	설명
	IDbConnection.BeginTransaction()	(DbConnection에서 상속)
	IDbConnection.BeginTransaction(IsolationLevel)	(DbConnection에서 상속)
	IDbConnection.CreateCommand	(DbConnection에서 상속)

맨 위로 이동

주의

SqlCeConnection 개체는 데이터 원본에의 고유한 연결을 나타냅니다. SqlCeConnection의 인스턴스를 만드는 경우 모든 속성이 초기 값으로 설정됩니다. 이러한 값에 대한 목록은 SqlCeConnection 생성자를 참조하십시오.

SqlCeConnection이 범위를 벗어나면 닫히지 않습니다. 그러므로 Close나 Dispose를 호출하여 명시적으로 연결을 끊어야 합니다.

SQL Server Compact는 다중 동시 연결뿐만 아니라 같은 연결을 공유하는 다중 명령을 지원합니다. 따라서 같은 연결에서 여러 개의 SqlCeDataReader 인스턴스를 열 수 있습니다. 이 동작은 System.Data.SqlClient의 동작과 다릅니다.

SqlCeCommand를 실행하는 메서드에서 심각한 SqlCeException이 생성되면 SqlCeConnection이 끊길 수도 있습니다. 그러나 다시 연결하여 계속할 수 있습니다.

예

다음 예제에서는 SqlCeCommand 및 SqlCeConnection를 만듭니다. SqlCeConnection이 열리고 SqlCeCommand에 대한 Connection으로 설정됩니다. 그런 다음 예제에서는 ExecuteNonQuery를 호출하고 연결을 닫습니다.

Dim conn As SqlCeConnection = Nothing

Try
    conn = New SqlCeConnection("Data Source = MyDatabase.sdf; Password ='<pwd>'")
    conn.Open()

    Dim cmd As SqlCeCommand = conn.CreateCommand()
    cmd.CommandText = "INSERT INTO Customers ([Customer ID], [Company Name]) Values('NWIND', 'Northwind Traders')"

    cmd.ExecuteNonQuery()
Finally
    conn.Close()
End Try

SqlCeConnection conn = null;

try
{
    conn = new SqlCeConnection("Data Source = MyDatabase.sdf; Password ='<pwd>'");
    conn.Open();

    SqlCeCommand cmd = conn.CreateCommand();
    cmd.CommandText = "INSERT INTO Customers ([Customer ID], [Company Name]) Values('NWIND', 'Northwind Traders')";

    cmd.ExecuteNonQuery();
}
finally
{
    conn.Close();
}

스레드 보안

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

참고 항목

참조

System.Data.SqlServerCe 네임스페이스

SqlCeDataAdapter

SqlCeCommand