Класс SqlCeError

  • Статья

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

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

System.Object
  System.Data.SqlServerCe.SqlCeError

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

Синтаксис

'Декларация
<SerializableAttribute> _
Public NotInheritable Class SqlCeError
'Применение
Dim instance As SqlCeError

[SerializableAttribute]
public sealed class SqlCeError

[SerializableAttribute]
public ref class SqlCeError sealed

[<SealedAttribute>]
[<SerializableAttribute>]
type SqlCeError =  class end

public final class SqlCeError

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

Свойства

  Имя Описание
Открытое свойство ErrorParameters Получает последние три параметра ошибки. Параметры ошибок в SQL Server Compact предоставляют дополнительные сведения об ошибке.
Открытое свойство HResult Возвращает дескриптор HRESULT, идентифицирующий тип ошибки.
Открытое свойство Message Возвращает текст, содержащий описание ошибки.
Открытое свойство NativeError Возвращает собственный код ошибки SqlCeError. Дополнительные сведения об отдельных ошибках см. в подразделе «Ошибки SQL Server Compact» раздела «Устранение неполадок» электронной документации по SQL Server Compact.
Открытое свойство NumericErrorParameters Возвращает первые три параметра ошибки. Параметры ошибок в SQL Server Compact предоставляют дополнительные сведения об ошибке.
Открытое свойство Source Возвращает имя поставщика, выдавшего ошибку.

В начало

Методы

  Имя Описание
Открытый метод Equals (унаследовано из Object)
Защищенный метод Finalize (унаследовано из Object)
Открытый метод GetHashCode (унаследовано из Object)
Открытый метод GetType (унаследовано из Object)
Защищенный метод MemberwiseClone (унаследовано из Object)
Открытый метод ToString Возвращает полный текст сообщения об ошибке. (Переопределяет Object.ToString().)

В начало

Замечания

Экземпляр SqlCeError создается управляемым поставщиком System.Data.SqlServerCe в момент возникновения ошибки. Коллекция SqlCeErrorCollection содержит один или несколько экземпляров объекта SqlCeError.

Примеры

Следующий пример демонстрирует типичное использование функции SqlCeError.

Try
    Dim repl As New SqlCeReplication()

    ' Fill repl properites here
    ' ...
    ' SqlCeReplication may throw SqlCeException which contains a 
    ' collection of errors; SQL Mobile database engine always
    ' returns one error in the collection
    '
    repl.Synchronize()
Catch e As SqlCeException
    Dim err As SqlCeError
    For Each err In e.Errors
        ' Use SqlCeError properties if you need specific
        ' application logic depending on the error condition
        '
        If 28577 = [err].NativeError Then 'SSCE_M_SCHEMAHASCHANGED
            ' Error specific logic goes here...
            '
        End If

        ' Note: For native error numbers, refer to SQL Server Mobile Errors
        ' in the SQL Server Mobile Books Online
        '
        MessageBox.Show([err].Message)
    Next err
End Try

try
{
    SqlCeReplication repl = new SqlCeReplication();

    // Fill repl properites here
    // ...

    // SqlCeReplication may throw SqlCeException which contains a 
    // collection of errors; SQL Mobile database engine always
    // returns one error in the collection
    //
    repl.Synchronize();
}
catch (SqlCeException e)
{
    foreach (SqlCeError error in e.Errors)
    {
        // Use SqlCeError properties if you need specific
        // application logic depending on the error condition
        //
        if (28577 == error.NativeError /*SSCE_M_SCHEMAHASCHANGED*/)
        {
            // Error specific logic goes here...
            //
        }

        // Note: For native error numbers, refer to SQL Server Mobile Errors
        // in the SQL Server Mobile Books Online
        //
        MessageBox.Show(error.Message);
    }
}

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

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

См. также

Справочник

Пространство имен System.Data.SqlServerCe

SqlCeErrorCollection

SqlCeException