Partilhar via


Método GetDatabaseInfo

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))
'Uso
Dim instance As SqlCeConnection
Dim returnValue As List(Of KeyValuePair(Of String, String))

returnValue = instance.GetDatabaseInfo()
public List<KeyValuePair<string, string>> GetDatabaseInfo()
public:
List<KeyValuePair<String^, String^>>^ GetDatabaseInfo()
member GetDatabaseInfo : unit -> List<KeyValuePair<string, string>> 
public function GetDatabaseInfo() : List<KeyValuePair<String, String>>

Valor de retorno

Tipo: System.Collections.Generic. . :: . .List< (Of < ( <'KeyValuePair< (Of < ( <'String, String> ) > ) >> ) > ) >
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.

Exemplos

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

Consulte também

Referência

SqlCeConnection Classe

Membros SqlCeConnection

Namespace System.Data.SqlServerCe