SqlCeConnection Constructor (String)

Article
10/22/2007

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
)

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

.NET Framework Security

Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see .

Platforms

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

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

Version Information

.NET Compact Framework

Supported in: 2.0, 1.0