SqlCeConnection.GetDatabaseInfo Method
Retourne un jeu de paires clé/valeur avec des informations relatives aux paramètres régionaux, au mode de chiffrement et au paramètre de respect de la casse de la base de données connectée.
Espace de noms: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (dans system.data.sqlserverce.dll)
Syntaxe
'Déclaration
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>>
Valeur de retour
Liste triée avec les paires nom/valeur des paramètres régionaux, mode de chiffrement et respect de la casse.
Remarques
Les valeurs du mode de chiffrement peuvent ne pas être celles spécifiées par l'utilisateur. Pour une base de données créée sur un appareil PPC2003, le mode de chiffrement retourné est Compatibilité PC2003. L'utilisateur peut avoir spécifié soit Platform default soit PPC2003 compatibility comme mode de chiffrement.
Cela s'explique du fait que le mode Platform default des appareils PPC2003 correspond à PPC2003 compatibility et que pour les autres appareils et/ou ordinateurs de bureau, il correspond à Engine Default.
Exemple
L'exemple suivant utilise GetDatabaseInfo pour récupérer les propriétés de base de données de Northwind.sdf. Une chaîne de connexion est passée à SqlCeConnection, qui ouvre une connexion à la base de données. Une fois la connexion ouverte, le contenu de GetDatabaseInfo est stocké dans un KeyValuePair et affiché dans la 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();
}
Sécurité des threads
Tout membre statique public (Partagé dans Microsoft Visual Basic) de ce type sont thread-safe. Tous les membres de l'instance ne sont pas garantis comme sûrs.
Plateformes
Plateformes de développement
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
Informations sur la version
.NET Framework et NET Compact Framework
Pris en charge dans 3.5
.NET Framework
Pris en charge dans 3.0
.NET Compact Framework et .Net Framework
Pris en charge dans 2.0
Voir aussi
Référence
SqlCeConnection Class
SqlCeConnection Members
System.Data.SqlServerCe Namespace