Класс SqlCeException

Статья
05/27/2011

Исключение, возникающее при возврате базовым поставщиком предупреждения или ошибки из источника данных SQL Server Compact. Этот класс не может быть унаследован.

Иерархия наследования

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

Пространство имен: System.Data.SqlServerCe
Сборка: System.Data.SqlServerCe (в System.Data.SqlServerCe.dll)

Синтаксис

'Декларация
<SerializableAttribute> _
Public Class SqlCeException _
    Inherits DbException
'Применение
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

Тип SqlCeException обеспечивает доступ к следующим элементам.

Конструкторы

	Имя	Описание
	SqlCeException	Конструктор, который помогает выполнить сериализацию.

В начало

Свойства

	Имя	Описание
	Data	(унаследовано из Exception)
	ErrorCode	(унаследовано из ExternalException)
	Errors	Возвращает коллекцию из одного или нескольких объектов SqlCeError, которые содержат подробные сведения об исключениях, вызванных поставщиком данных .NET Compact Framework для SQL Server Compact.
	HelpLink	(унаследовано из Exception)
	HResult	Возвращает значение HRESULT для исключения. Это то же самое значение, что доступно через свойство HResult первого экземпляра объекта SqlCeError в коллекции SqlCeErrorCollection для данного исключения.
	InnerException	(унаследовано из Exception)
	Message	Возвращает текст, описывающий первый экземпляр SqlCeError в коллекции SqlCeErrorCollection для данного исключения. (Переопределяет Exception.Message.)
	NativeError	Возвращает собственный код ошибки первого экземпляра SqlCeError коллекции SqlCeErrorCollection. Дополнительные сведения об ошибках см. в подразделе «Ошибки SQL Server Compact» раздела «Устранение неполадок» электронной документации по SQL Server Compact.
	Source	Возвращает имя поставщика OLE DB, который сформировал ошибку. (Переопределяет Exception.Source.)
	StackTrace	(унаследовано из Exception)
	TargetSite	(унаследовано из Exception)

В начало

Методы

	Имя	Описание
	Equals	(унаследовано из Object)
	Finalize	(унаследовано из Object)
	GetBaseException	(унаследовано из Exception)
	GetHashCode	(унаследовано из Object)
	GetObjectData	Важный элемент безопасности. Наполняет объект SerializationInfo данными, которые требуются для сериализации объекта. (Переопределяет Exception.GetObjectData(SerializationInfo, StreamingContext).)
	GetType	(унаследовано из Exception)
	MemberwiseClone	(унаследовано из Object)
	ToString	(унаследовано из Exception)

В начало

Замечания

Этот класс создается каждый раз, когда поставщик данных .NET Compact Framework для SQL Server Compact обнаруживает ошибку ядра SQL Server Compact (все остальные ошибки возникают в виде стандартных исключений CLR). Исключение SqlCeException всегда содержит как минимум один экземпляр объектаSqlCeError.

Примеры

В следующем примере возникает исключение SqlCeException, обусловленное отсутствием источника данных, после чего это исключение отображается.

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

Безопасность многопоточности

Все общие статические члены (Shared в Microsoft Visual Basic) этого типа можно использовать в потокобезопасных операциях. Потокобезопасная работа с членами экземпляров типа не гарантируется.