Condividi tramite


SqlCeConnection.GetDatabaseInfo Method

Restituisce un set di coppie chiave/valore con informazioni sulle impostazioni locali, sulla modalità di crittografia e sull'impostazione relativa alla distinzione tra maiuscole e minuscole del database connesso.

Spazio dei nomi: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (in system.data.sqlserverce.dll)

Sintassi

'Dichiarazione
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>>

Valore restituito

Elenco ordinato con le coppie nome/valore delle impostazioni locali, della modalità di crittografia e della distinzione tra maiuscole e minuscole.

Osservazioni

I valori della modalità di crittografia non possono essere gli stessi di quelli specificati dall'utente. Per un database creato su un dispositivo di PPC2003, la modalità di crittografia restituita è PPC2003 Compatibility. È probabile che l'utente abbia specificato Platform default o PPC2003 compatibility come modalità di crittografia.

La situazione illustrata in alto si verifica quando nella modalità Platform default dei dispositivi PPC2003 viene eseguito il mapping con PPC2003 compatibility e per altri dispositivi e/o desktop viene eseguito il mapping in Engine Default.

Esempio

Nell'esempio seguente viene utilizzato GetDatabaseInfo per recuperare le proprietà di database di Northwind.sdf. A SqlCeConnection viene passata una stringa di connessione e successivamente viene stabilita una connessione al database. Una volta aperta la connessione, il contenuto di GetDatabaseInfo viene archiviato in un valore KeyValuePair e visualizzato nella 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();
}

Affidabilità

Tutti i membri statici pubblici (Shared in Microsoft Visual Basic) di questo tipo sono affidabili. Non è invece garantita l'affidabilità dei membri dell'istanza.

Piattaforme

Piattaforme di sviluppo

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
Informazioni sulla versione
.NET Framework e .NET Compact Framework
Supportato in 3.5
.NET Framework
Supportato in 3.0
.NET Compact Framework e .NET Framework
Supportato in 2.0

Vedere anche

Riferimento

SqlCeConnection Class
SqlCeConnection Members
System.Data.SqlServerCe Namespace