SqlCeConnection.GetDatabaseInfo Method

Artigo
01/14/2011

Retorna um conjunto de pares de Valor de Chave com informações sobre a localidade, o modo de criptografia e a configuração de distinção entre maiúsculas e minúsculas do banco de dados conectado.

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

Sintaxe

'Declaração
Public Function GetDatabaseInfo As List(Of KeyValuePair(Of String, String))

public List<KeyValuePair<string,string>> GetDatabaseInfo ()

public:
List<KeyValuePair<String^, String^>>^ GetDatabaseInfo ()

public List<KeyValuePair<String,String>> GetDatabaseInfo ()

public function GetDatabaseInfo () : List<KeyValuePair<String,String>>

Valor de retorno

Lista classificada com os pares de valores de localidade, modo de criptografia e distinção entre maiúsculas e minúsculas.

Comentários

Os valores de modo de criptografia podem não ser iguais aos especificados pelo usuário. Para um banco de dados criado em um dispositivo PPC2003, o Modo de Criptografia retornado é PPC2003 Compatibility. O usuário pode ter especificado Platform default ou PPC2003 compatibility como modo de criptografia.

O comportamento acima ocorre porque, nos dispositivos PPC2003, o modo Platform default é mapeado como PPC2003 compatibility e, nos outros dispositivos e/ou em desktops, ele é mapeado como Engine Default.

Exemplo

O exemplo a seguir usa GetDatabaseInfo para recuperar as propriedades do banco de dados Northwind.sdf. É passada uma cadeia de conexão a SqlCeConnection e, em seguida, é aberta uma conexão com o banco de dados. Uma vez que a conexão é aberta, o conteúdo de GetDatabaseInfo é armazenado em um KeyValuePair e exibido no console.

Dim connStr As String = Nothing
Dim databasePath As String = Nothing
Dim sqlconn As SqlCeConnection = Nothing

Try
    'Defining database parameters
    databasePath = "C:\Program Files\Microsoft SQL Server Compact Edition\v3.5\Samples\Northwind.sdf"
    'If the database already exists, the existing encryption mode will supercede the supplied mode
    connStr = "Data Source=" & databasePath & ";Encryption Mode = 'ppc2003 compatibility';Password='password'"

    'Connecting to the database and opening the connection
    sqlconn = New SqlCeConnection(connStr)
    sqlconn.Open()

    'Retrieving the database information
    Dim dbinfo As List(Of KeyValuePair(Of String, String)) = sqlconn.GetDatabaseInfo

    Console.WriteLine("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
    'Dispose the connection's resources
    sqlconn.Dispose()

    Console.WriteLine(vbNewLine & vbNewLine & vbNewLine & "Press any key to continue...")
    Console.Read()
End Try

string connStr = null;
string databasePath = null;
SqlCeConnection sqlconn = null;

try
{
    //Defining database parameters
    databasePath = @"C:\Program Files\Microsoft SQL Server Compact Edition\v3.5\Samples\Northwind.sdf";
    //If the database already exists, the existing encryption mode will supercede the supplied mode
    connStr = "Data Source=" + databasePath + ";Encryption Mode = 'ppc2003 compatibility';Password='sa'";
    
    //Connecting to the database and opening the connection
    sqlconn = new SqlCeConnection(connStr);
    sqlconn.Open();
    
    //Retrieving the database information 
    List<KeyValuePair<string, string>> dbinfo = sqlconn.GetDatabaseInfo();
    
    Console.WriteLine("GetDatabaseInfo() results:");
    
    foreach (KeyValuePair<string, string> kvp in dbinfo)
    {
        Console.WriteLine(kvp);
    }
    
}
catch (Exception ex)
{
    Console.WriteLine(ex.Message);
}
finally
{
    //Dispose the connection's resources
    sqlconn.Dispose();

    Console.WriteLine("\n\n\nPress any key to continue...");
    Console.Read();
}

Segurança de thread

Quaisquer membros estáticos públicos (compartilhados no Microsoft Visual Basic) desse tipo são thread safe. Não há garantia de que qualquer membro de instância seja thread safe.

Plataformas

Plataformas de desenvolvimento

Windows Vista, Windows Mobile 5.0, Windows XP Professional with Service Pack 2 (SP2), Windows Server 2003, Windows Mobile 2003 for Pocket PC, Windows CE 5.0
Informações de versão
.NET Framework e NET Compact Framework
Com suporte no 3.5
.NET Framework
Com suporte no 3.0
.NET Compact Framework e .Net Framework
Com suporte no 2.0

Consulte também

Referência

SqlCeConnection Class
SqlCeConnection Members
System.Data.SqlServerCe Namespace

Partilhar via