SqlCeConnection.SqlCeConnection(String) Constructor

Initializes a new instance of the SqlCeConnection class with the specified connection string.

Namespace: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (in system.data.sqlserverce.dll)

Syntax

'Declaration
Public Sub New ( _
    connectionString As String _
)
'Usage
Dim connectionString As String

Dim instance As New SqlCeConnection(connectionString)

public SqlCeConnection (
    string connectionString
)

public:
SqlCeConnection (
    String^ connectionString
)

public SqlCeConnection (
    String connectionString
)

public function SqlCeConnection (
    connectionString : String
)

Not applicable.

Parameters

• connectionString
  The connection used to open the database.

Remarks

When a new instance of SqlCeConnection is created, the read/write properties are set to the following initial values unless they are set specifically by using their associated keywords in the ConnectionString property.

Properties	Initial Value
ConnectionString	connectionString
DataSource	empty string ("")

You can change the value for these properties only by using the ConnectionString property.

Example

The following example creates and opens a SqlCeConnection.

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();
}

Platforms

Windows CE, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows XP Professional x64 Edition, Windows XP SP2

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

Version Information

.NET Framework

Supported in: 3.0

.NET Compact Framework

Supported in: 2.0, 1.0

See Also

Reference

SqlCeConnection Class
SqlCeConnection Members
System.Data.SqlServerCe Namespace