Класс SqlCeError

Статья
05/27/2011

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

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

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) этого типа можно использовать в потокобезопасных операциях. Потокобезопасная работа с членами экземпляров типа не гарантируется.