Condividi tramite


Classe SqlCeException

Eccezione generata quando il provider sottostante restituisce un avviso oppure un errore da un'origine dati SQL Server Compact. Questa classe non può essere ereditata.

Gerarchia di ereditarietà

System.Object
  System.Exception
    System.SystemException
      System.Runtime.InteropServices.ExternalException
        System.Data.Common.DbException
          System.Data.SqlServerCe.SqlCeException
            System.Data.SqlServerCe.SqlCeInvalidDatabaseFormatException
            System.Data.SqlServerCe.SqlCeLockTimeoutException
            System.Data.SqlServerCe.SqlCeTransactionInProgressException

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

Sintassi

'Dichiarazione
<SerializableAttribute> _
Public Class SqlCeException _
    Inherits DbException
'Utilizzo
Dim instance As SqlCeException
[SerializableAttribute]
public class SqlCeException : DbException
[SerializableAttribute]
public ref class SqlCeException : public DbException
[<SerializableAttribute>]
type SqlCeException =  
    class
        inherit DbException
    end
public class SqlCeException extends DbException

Nel tipo SqlCeException sono esposti i membri seguenti.

Costruttori

  Nome Descrizione
Metodo protetto SqlCeException Costruttore che consente la serializzazione.

In alto

Proprietà

  Nome Descrizione
Proprietà pubblica Data (ereditato da Exception)
Proprietà pubblica ErrorCode (ereditato da ExternalException)
Proprietà pubblica Errors Ottiene una raccolta di uno o più oggetti SqlCeError che contengono informazioni dettagliate relative alle eccezioni generate dal provider di dati .NET Compact Framework per SQL Server Compact.
Proprietà pubblica HelpLink (ereditato da Exception)
Proprietà pubblica HResult Ottiene il valore HRESULT dell'eccezione. Questo valore equivale a quello della proprietà HResult per la prima istanza dell'oggetto SqlCeError nell'oggetto SqlCeErrorCollection per l'eccezione.
Proprietà pubblica InnerException (ereditato da Exception)
Proprietà pubblica Message Ottiene il testo che descrive la prima istanza dell'oggetto SqlCeError nell'oggetto SqlCeErrorCollection per questa eccezione. Esegue l'override di Exception.Message.
Proprietà pubblica NativeError Ottiene il numero di errore nativo del primo oggetto SqlCeError nell'oggetto SqlCeErrorCollection. Per ulteriori informazioni sugli errori, vedere l'argomento relativo agli errori in SQL Server Compact nella sezione sulla risoluzione dei problemi della documentazione online di SQL Server Compact.
Proprietà pubblica Source Ottiene il nome del provider OLE DB che ha generato l’errore. Esegue l'override di Exception.Source.
Proprietà pubblica StackTrace (ereditato da Exception)
Proprietà pubblica TargetSite (ereditato da Exception)

In alto

Metodi

  Nome Descrizione
Metodo pubblico Equals (ereditato da Object)
Metodo protetto Finalize (ereditato da Object)
Metodo pubblico GetBaseException (ereditato da Exception)
Metodo pubblico GetHashCode (ereditato da Object)
Metodo pubblico GetObjectData Criticità per la sicurezza. Popola un oggetto SerializationInfo con i dati richiesti per serializzare l'oggetto. Esegue l'override di Exception.GetObjectData(SerializationInfo, StreamingContext).
Metodo pubblico GetType (ereditato da Exception)
Metodo protetto MemberwiseClone (ereditato da Object)
Metodo pubblico ToString (ereditato da Exception)

In alto

Osservazioni

Questa classe viene creata ogni volta che il provider di dati .NET Compact Framework per SQL Server Compact rileva un errore generato dal motore di SQL Server Compact. Altri errori vengono generati come eccezioni Common Language Runtime standard. L'oggetto SqlCeException contiene sempre almeno un'istanza di SqlCeError.

Esempi

Nell'esempio seguente viene generata un'eccezione SqlCeException causata dalla mancanza di un'origine dati; in seguito l'eccezione viene visualizzata.

Dim conn As New SqlCeConnection("Data Source=nonExistingSource.sdf;")

Try
    conn.Open()
Catch e As SqlCeException
    ' Use SqlCeException properties if you need specific
    ' application logic depending on the error condition
    '
    If 25046 = e.NativeError Then 'SSCE_M_FILENOTFOUND
        ' Error specific logic goes here...
        '
    End If

    MessageBox.Show(e.Message)
End Try
SqlCeConnection conn = new SqlCeConnection("Data Source=nonExistingSource.sdf;");

try
{
    conn.Open();
}
catch (SqlCeException e)
{
    // Use SqlCeException properties if you need specific
    // application logic depending on the error condition
    //
    if (25046 == e.NativeError /*SSCE_M_FILENOTFOUND*/)
    {
        // Error specific logic goes here...
        //
    }

    MessageBox.Show(e.Message);
}

Protezione dei thread

I membri statici pubblici (Shared in Microsoft Visual Basic) di questo tipo sono thread-safe. Non è invece garantita la sicurezza dei membri dell'istanza.

Vedere anche

Riferimento

Spazio dei nomi System.Data.SqlServerCe

SqlCeError

SqlCeErrorCollection