DAUpdatesFailedException

Overview

The DAUpdatesFailedException class represents exceptions that are raised during the execution of updates on the client side. Exceptions of the type DAUpdatesFailedException are raised by DataAdapter and LinqDataAdapter descendants when there is a failure on the server side while applying data changes.

NOTE: DAUpdatesFailedException instance can hold collection of failed changes. Thus it is impossible to serialize it and send over the network. Actually this kind of exceptions throws and handles by the DA within the same layer (on the client side - if we are using remote data adapters or on the server side - if we are using local data adapters), so it is not supposed to be serialized into the binary stream.

If you are using Local Data Adapters and catch that exception, then you will need to process it in place, then convert into DAException, which can be serialized, and sent back to the client.

Location

 

constructor    (declared in ServerException)

 

constructor

 

DAUpdatesFailedException()

 

Sub New

constructor (String)

Initializes a new DAUpdatesFailedException object with a specified error message aMessage and an empty list of failed changes.

 

constructor(message: String)

 

DAUpdatesFailedException(String message)

 

Sub New (message As String)

Parameters:

  • message:

constructor (String, array of DeltaChange)

 

constructor(message: String; changes: array of DeltaChange)

 

DAUpdatesFailedException(String message, DeltaChange[] changes)

 

Sub New (message As String, changes As array of DeltaChange)

Parameters:

  • message:
  • changes:

constructor (String, array of Object)    (declared in DAException)

Creates a new instance of the DAException class with the given exception message and parameters.

 

constructor(message: String; params parameters: array of Object)

 

DAUpdatesFailedException(String message, params Object[] parameters)

 

Sub New (message As String, ParamArray parameters As array of Object)

Parameters:

  • message:
  • parameters:

constructor (String, Boolean)    (declared in DAException)

Creates a new instance of the DAException class with the given exception message. The boolean flag aFromServer indicates whether exceptions occured on the server or on the client side.

If aFromServer is set to true, the exception message will be prefixed with "An exception occurred on the server: " string.

 

constructor(message: String; fromServer: Boolean)

 

DAUpdatesFailedException(String message, Boolean fromServer)

 

Sub New (message As String, fromServer As Boolean)

Parameters:

  • message:
  • fromServer:

constructor (String, Exception)    (declared in DAException)

 

constructor(message: String; innerException: Exception)

 

DAUpdatesFailedException(String message, Exception innerException)

 

Sub New (message As String, innerException As Exception)

Parameters:

  • message:
  • innerException:

constructor (SerializationInfo, StreamingContext)  protected    (declared in DAException)

Creates a new instance of the DAException class with serialized data.

 

constructor(info: SerializationInfo; context: StreamingContext)

 

DAUpdatesFailedException(SerializationInfo info, StreamingContext context)

 

Sub New (info As SerializationInfo, context As StreamingContext)

Parameters:

  • info:
  • context:

Changes

The list of DeltaChange objects that contain failed data changes.

 

property Changes: array of DeltaChange read;

 

DeltaChange[] Changes { get; }

 

Property ReadOnly Changes As array of DeltaChange

FromServer    (declared in ServerException)

This property is set to true if the exception was received from the server and was re-thrown on the client tier. It's false if the exception was thrown on the same tier as the code processing it.

 

property FromServer: Boolean read;

 

Boolean FromServer { get; }

 

Property ReadOnly FromServer As Boolean

GetAttributeCount    (declared in ServerException)

 

method GetAttributeCount: Int32

 

Int32 GetAttributeCount()

 

Function GetAttributeCount As Int32

GetAttributeName    (declared in ServerException)

 

method GetAttributeName(index: Int32): String

 

String GetAttributeName(Int32 index)

 

Function GetAttributeName(index As Int32) As String

Parameters:

  • index:

GetAttributeValue    (declared in ServerException)

 

method GetAttributeValue(index: Int32): String

 

String GetAttributeValue(Int32 index)

 

Function GetAttributeValue(index As Int32) As String

Parameters:

  • index:

ServerStackTrace    (declared in ServerException)

The stack trace of the exception location obtained from the server, if available.

 

property ServerStackTrace: String read write;

 

String ServerStackTrace { get; set; }

 

Property ServerStackTrace As String

 

Changes

The list of DeltaChange objects that contain failed data changes.

 

property Changes: array of DeltaChange read;

 

DeltaChange[] Changes { get; }

 

Property ReadOnly Changes As array of DeltaChange

FromServer    (declared in ServerException)

This property is set to true if the exception was received from the server and was re-thrown on the client tier. It's false if the exception was thrown on the same tier as the code processing it.

 

property FromServer: Boolean read;

 

Boolean FromServer { get; }

 

Property ReadOnly FromServer As Boolean

ServerStackTrace    (declared in ServerException)

The stack trace of the exception location obtained from the server, if available.

 

property ServerStackTrace: String read write;

 

String ServerStackTrace { get; set; }

 

Property ServerStackTrace As String

 

constructor    (declared in ServerException)

 

constructor

 

DAUpdatesFailedException()

 

Sub New

constructor (String)

Initializes a new DAUpdatesFailedException object with a specified error message aMessage and an empty list of failed changes.

 

constructor(message: String)

 

DAUpdatesFailedException(String message)

 

Sub New (message As String)

Parameters:

  • message:

constructor (String, array of DeltaChange)

 

constructor(message: String; changes: array of DeltaChange)

 

DAUpdatesFailedException(String message, DeltaChange[] changes)

 

Sub New (message As String, changes As array of DeltaChange)

Parameters:

  • message:
  • changes:

constructor (String, array of Object)    (declared in DAException)

Creates a new instance of the DAException class with the given exception message and parameters.

 

constructor(message: String; params parameters: array of Object)

 

DAUpdatesFailedException(String message, params Object[] parameters)

 

Sub New (message As String, ParamArray parameters As array of Object)

Parameters:

  • message:
  • parameters:

constructor (String, Boolean)    (declared in DAException)

Creates a new instance of the DAException class with the given exception message. The boolean flag aFromServer indicates whether exceptions occured on the server or on the client side.

If aFromServer is set to true, the exception message will be prefixed with "An exception occurred on the server: " string.

 

constructor(message: String; fromServer: Boolean)

 

DAUpdatesFailedException(String message, Boolean fromServer)

 

Sub New (message As String, fromServer As Boolean)

Parameters:

  • message:
  • fromServer:

constructor (String, Exception)    (declared in DAException)

 

constructor(message: String; innerException: Exception)

 

DAUpdatesFailedException(String message, Exception innerException)

 

Sub New (message As String, innerException As Exception)

Parameters:

  • message:
  • innerException:

constructor (SerializationInfo, StreamingContext)  protected    (declared in DAException)

Creates a new instance of the DAException class with serialized data.

 

constructor(info: SerializationInfo; context: StreamingContext)

 

DAUpdatesFailedException(SerializationInfo info, StreamingContext context)

 

Sub New (info As SerializationInfo, context As StreamingContext)

Parameters:

  • info:
  • context:

GetAttributeCount    (declared in ServerException)

 

method GetAttributeCount: Int32

 

Int32 GetAttributeCount()

 

Function GetAttributeCount As Int32

GetAttributeName    (declared in ServerException)

 

method GetAttributeName(index: Int32): String

 

String GetAttributeName(Int32 index)

 

Function GetAttributeName(index As Int32) As String

Parameters:

  • index:

GetAttributeValue    (declared in ServerException)

 

method GetAttributeValue(index: Int32): String

 

String GetAttributeValue(Int32 index)

 

Function GetAttributeValue(index As Int32) As String

Parameters:

  • index:

See Also