SqlCeConnection.GetDatabaseInfo Method

Devuelve un conjunto de pares de clave y valor con información sobre la configuración regional, el modo de cifrado y la configuración de distinción entre mayúsculas y minúsculas de la base de datos conectada.

Espacio de nombres: System.Data.SqlServerCe
Ensamblado: System.Data.SqlServerCe (en system.data.sqlserverce.dll)

Sintaxis

'Declaración
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 devuelto

Una lista ordenada con los pares de nombre y valor de la configuración regional, el modo de cifrado y la configuración de distinción entre mayúsculas y minúsculas.

Notas

Es posible que los valores de modo de cifrado no sean los mismos que los especificados por el usuario. Para una base de datos creada en un dispositivo PPC2003, el modo de cifrado devuelto es PPC2003 Compatibility. Es posible que el usuario haya especificado Platform default o PPC2003 compatibility como el modo de cifrado.

El comportamiento anterior se debe a que en los dispositivos PPC2003 el modo Platform default se asigna a PPC2003 compatibility y para otros dispositivos o equipo de escritorio se asigna a Engine Default.

Ejemplo

En el ejemplo siguiente se usa GetDatabaseInfo para recuperar las propiedades de base de datos de Northwind.sdf. Se pasa una cadena de conexión a SqlCeConnection y, a continuación, se abre una conexión con la base de datos. Una vez abierta la conexión, el contenido de GetDatabaseInfo se almacena en un KeyValuePair y se muestra en la consola.

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

Seguridad para subprocesos

Todos los miembros (Compartidos en Microsoft Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Plataformas

Plataformas de desarrollo

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
Información de la versión
.NET Framework y NET Compact Framework
Se admite en 3.5
.NET Framework
Se admite en 3.0
.NET Compact Framework y .Net Framework
Se admite en 2.0

Vea también

Referencia

SqlCeConnection Class
SqlCeConnection Members
System.Data.SqlServerCe Namespace