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 (SerializationInfo, StreamingContext)  protected    (declared in DAException)

Creates a new instance with serialized data.

 

constructor(info: SerializationInfo; context: StreamingContext)

 

DAUpdatesFailedException(SerializationInfo info, StreamingContext context)

 

Sub New(info As SerializationInfo, context As StreamingContext)

Parameters:

  • info: Serialized data about the exception being thrown
  • context: The System.Runtime.Serialization.StreamingContext instance that contains conceptial information about the source or destination

constructor (String)

Creates a new instance with the given exception message.

 

constructor(message: String)

 

DAUpdatesFailedException(String message)

 

Sub New(message As String)

Parameters:

  • message: Exception message

constructor (String, array of DeltaChange)

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

 

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

 

DAUpdatesFailedException(String message, DeltaChange[] changes)

 

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

Parameters:

  • message:
  • changes:

constructor (String, Boolean)    (declared in DAException)

Creates a new instance 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: Exception message
  • fromServer: Flag indicating whether exception was initially raised on the remote server

constructor (String, Exception)    (declared in DAException)

Creates a new instance with inner exception

 

constructor(message: String; innerException: Exception)

 

DAUpdatesFailedException(String message, Exception innerException)

 

Sub New(message As String, innerException As Exception)

Parameters:

  • message: Exception message.
  • innerException: Inner exception

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

Creates a new instance 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 Object())

Parameters:

  • message: Exception message. Can contain placeholders that will be filled using the vaues of the parameters argument. This argument accepts the same format string as the String.Format method
  • parameters: Values(s) of this argument will be substituted to the placeholders contained in the message format string

Changes

The list of DeltaChange objects that contain failed data changes.

 

property Changes: array of DeltaChange read;

 

DeltaChange[] Changes { get; }

 

ReadOnly Property Changes() As 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; }

 

ReadOnly Property 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:

OriginalExceptionClassName    (declared in ServerException)

 

property OriginalExceptionClassName: String read write;

 

String OriginalExceptionClassName { get; set; }

 

Property OriginalExceptionClassName() As String

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

ToString    (declared in ServerException)

 

method ToString: String

 

String ToString()

 

Function ToString() As String

 

Changes

The list of DeltaChange objects that contain failed data changes.

 

property Changes: array of DeltaChange read;

 

DeltaChange[] Changes { get; }

 

ReadOnly Property Changes() As 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; }

 

ReadOnly Property FromServer() As Boolean

OriginalExceptionClassName    (declared in ServerException)

 

property OriginalExceptionClassName: String read write;

 

String OriginalExceptionClassName { get; set; }

 

Property OriginalExceptionClassName() As String

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 (SerializationInfo, StreamingContext)  protected    (declared in DAException)

Creates a new instance with serialized data.

 

constructor(info: SerializationInfo; context: StreamingContext)

 

DAUpdatesFailedException(SerializationInfo info, StreamingContext context)

 

Sub New(info As SerializationInfo, context As StreamingContext)

Parameters:

  • info: Serialized data about the exception being thrown
  • context: The System.Runtime.Serialization.StreamingContext instance that contains conceptial information about the source or destination

constructor (String)

Creates a new instance with the given exception message.

 

constructor(message: String)

 

DAUpdatesFailedException(String message)

 

Sub New(message As String)

Parameters:

  • message: Exception message

constructor (String, array of DeltaChange)

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

 

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

 

DAUpdatesFailedException(String message, DeltaChange[] changes)

 

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

Parameters:

  • message:
  • changes:

constructor (String, Boolean)    (declared in DAException)

Creates a new instance 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: Exception message
  • fromServer: Flag indicating whether exception was initially raised on the remote server

constructor (String, Exception)    (declared in DAException)

Creates a new instance with inner exception

 

constructor(message: String; innerException: Exception)

 

DAUpdatesFailedException(String message, Exception innerException)

 

Sub New(message As String, innerException As Exception)

Parameters:

  • message: Exception message.
  • innerException: Inner exception

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

Creates a new instance 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 Object())

Parameters:

  • message: Exception message. Can contain placeholders that will be filled using the vaues of the parameters argument. This argument accepts the same format string as the String.Format method
  • parameters: Values(s) of this argument will be substituted to the placeholders contained in the message format string

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:

ToString    (declared in ServerException)

 

method ToString: String

 

String ToString()

 

Function ToString() As String