Como criar um banco de dados usando o objeto Engine (programaticamente)

Artigo
05/27/2011

Neste tópico, você aprenderá como criar programaticamente um banco de dados do SQL Server Compact usando o método CreateDatabase do objeto SqlServerCe.Engine. Para obter mais informações sobre como usar o namespace SqlServerCe, consulte a documentação de referência de namespaces do SqlServerCe.

Procedimentos do SQL Server Compact 4.0

Para criar um banco de dados usando o objeto Engine

Inicialize um novo objeto Engine.

SqlCeEngine engine = new SqlCeEngine();

Defina a propriedade LocalConnectionString do objeto Engine. A propriedade LocalConnectionString especifica o nome e o local do banco de dados que será criado, e pode especificar opções adicionais do banco de dados, incluindo a criptografia.
```
eng.LocalConnectionString= "Data Source='Test.sdf'; LCID=1033;" +
   "Password='<enterStrongPasswordHere>';";
```
Chame o método CreateDatabase para criar o banco de dados.
```
engine.CreateDatabase();
```

Como criar um banco de dados que diferencia maiúsculas de minúsculas usando o objeto Engine

Inicialize um novo objeto Engine.

SqlCeEngine engine = new SqlCeEngine();

Defina a propriedade LocalConnectionString do objeto Engine. A propriedade LocalConnectionString especifica o nome e o local do banco de dados que será criado e pode especificar também opções adicionais do banco de dados, incluindo a diferenciação de maiúsculas de minúsculas.
```
eng.LocalConnectionString= "Data Source='Test.sdf'; LCID=1033;" +
   "Password='<enterStrongPasswordHere>'; Case Sensitive = TRUE;";
```
Chame o método CreateDatabase para criar o banco de dados.
```
engine.CreateDatabase();
```

Exemplo

O primeiro exemplo cria um novo banco de dados chamado Test.sdf.

System.IO.File.Delete("Test.sdf");
string connString = "Data Source = 'Test.sdf'; LCID=1033; Password = <enterStrongPasswordHere>;";
SqlCeEngine engine = new SqlCeEngine(connString);
engine.CreateDatabase();

System.IO.File.Delete("Test.sdf")
Dim connString As String = "Data Source='Test.sdf'; LCID=1033; Password=<enterStrongPasswordHere>; Encrypt = TRUE;"
Dim engine As New SqlCeEngine(connString)
engine.CreateDatabase()

O segundo exemplo usa a propriedade LocalConnectionString, que suporta uma propriedade Boolean adicional chamada "Case Sensitive" ou "CaseSensitive". Essa propriedade pode ter um valor true ou false. O valor padrão é sempre false. Esta propriedade é introduzida a partir do SQL Server Compact versão 3.5 SP1. Para obter mais informações, consulte Trabalhando com agrupamentos (SQL Server Compact).

O exemplo demonstra como definir a propriedade que diferencia maiúsculas de minúsculas em uma cadeia de conexão usando a propriedade LocalConnectionString. Depois, o exemplo de código usa o método GetDatabaseInfo para recuperar a localidade, o modo de criptografia e a configuração de diferenciação de maiúsculas e minúsculas do banco de dados:

// First approach: 
// Create a case-sensitive database by using the SqlCeEngine 
// constructor.
if (File.Exists("Test.sdf"))
    File.Delete("Test.sdf");

// 1033: specifies the English locale with collation 
// SQL_Latin1_General_CP1_CI_AS
string connStr = 
   "Data Source='Test.sdf'; LCID=1033; Case Sensitive = TRUE";

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

// Second approach: 
// Create a case-sensitive database by using the LocalConnectionString 
// property.
if (File.Exists("Test.sdf"))
   File.Delete("Test.sdf");

SqlCeEngine engine2 = new SqlCeEngine();

engine2.LocalConnectionString = 
   "Data Source='Test.sdf'; LCID=1033; Case Sensitive = TRUE";
// 1033: specifies the English locale with collation 
// SQL_Latin1_General_CP1_CI_AS
engine2.CreateDatabase();
engine2.Dispose();

SqlCeConnection conn = null;

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

   //Retrieve the connection string information - 
   // notice the 'Case Sensitive' value
   List<KeyValuePair<string, string>> dbinfo = conn.GetDatabaseInfo();

   Console.WriteLine("\nGetDatabaseInfo() results:");

   foreach (KeyValuePair<string, string> kvp in dbinfo)
   {
      Console.WriteLine(kvp);
   }
   }
   catch (Exception ex)
   {
      Console.WriteLine(ex.Message);
   }
   finally
   {
      conn.Close();
      Console.WriteLine("\n\n\nPress any key to continue...");
      Console.Read();
   }

' First approach: 
' Create a case sensitive database by using the SqlCeEngine 
' constructor.
If File.Exists("Test.sdf") Then
    File.Delete("Test.sdf")
End If

' 1033: specifies the English locale with collation 
' SQL_Latin1_General_CP1_CI_AS
Dim connStr As String = "Data Source='Test.sdf'; LCID=1033; Case Sensitive = TRUE"

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

' Second approach: 
' Create a case-sensitive database by using the LocalConnectionString 
' property.
If File.Exists("Test.sdf") Then
    File.Delete("Test.sdf")
End If

Dim engine2 As New SqlCeEngine
engine2.LocalConnectionString = _
    "Data Source='Test.sdf'; LCID=1033; Case Sensitive = TRUE"
    ' 1033: specifies the English locale with collation 
    ' SQL_Latin1_General_CP1_CI_AS
engine2.CreateDatabase()
engine2.Dispose()

Dim conn As SqlCeConnection = Nothing

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

    'Retrieve the connection string information - 
    ' notice the 'Case Sensitive' value
    Dim dbinfo As List(Of KeyValuePair(Of String, String)) = conn.GetDatabaseInfo

    Console.WriteLine(ChrW(10) & "GetDatabaseInfo() results:")

    Dim kvp As KeyValuePair(Of String, String)

    For Each kvp In dbinfo
        Console.WriteLine(kvp)
    Next
Catch ex As Exception
    Console.WriteLine(ex.Message)
Finally
    conn.Close()
    Console.WriteLine(vbNewLine & vbNewLine & vbNewLine & "Press any key to continue...")
    Console.Read()
End Try

Consulte também

Conceitos

Visão geral do mecanismo de bancos de dados (SQL Server Compact)

Compartilhar via