ONE Active Server Pages Product Home Page Developer Site Version


ADO Recordset Object MarshalOptions Property

Indicates which records are to be marshaled back to the server. This is a client-side only property.

MarshalOptions Property Return Values

Sets or returns a Long value that can be one of the following constants:

Default. All rows are returned to the server.
Only modified rows are returned to the server.

MarshalOptions Property Remarks

When using a client-side (ADOR) recordset, records that have been modified on the client are written back to the middle-tier or Web server through a technique called marshaling, the process of packaging and sending interface method parameters across thread or process boundaries. Setting the MarshalOptions property can improve performance when modified remote data is marshaled for updating back to the middle-tier or Web server.

Remote Data Service Usage: This property is only used on a client-side (ADOR) recordset.

MarshalOptions Property Example

This Visual Basic example uses the MarshalOptions property to specify what rows are sent back to the server—All Rows or only Modified Rows.

Public Sub MarshalOptionsX() 
Dim rstEmployees As ADODB.Recordset 
Dim strCnn As String 
Dim strOldFirst As String 
Dim strOldLast As String 
Dim strMessage As String 
Dim strMarshalAll As String 
Dim strMarshalModified As String 
` Open recordset with names from Employee table. 
strCnn = "driver={SQL Server};server=srv;" & _ 
Set rstEmployees = New ADODB.Recordset 
rstEmployees.CursorType = adOpenKeyset 
rstEmployees.LockType = adLockOptimistic 
rstEmployees.CursorLocation = adUseClient 
rstEmployees.Open "SELECT fname, lname " & _ 
"FROM Employee ORDER BY lname", strCnn, , , adCmdText
` Store original data. 
strOldFirst = rstEmployees!fname 
strOldLast = rstEmployees!lname 
` Change data in edit buffer. 
rstEmployees!fname = "Linda" 
rstEmployees!lname = "Kobara"
` Show contents of buffer and get user input. 
strMessage = "Edit in progress:" & vbCr & _ 
" Original data = " & strOldFirst & " " & _ 
strOldLast & vbCr & " Data in buffer = " & _ 
rstEmployees!fname & " " & rstEmployees!lname & vbCr & vbCr & _ 
"Use Update to replace the original data with " & _ 
"the buffered data in the Recordset?" 
strMarshalAll = "Would you like to send all the rows " & _ 
"in the recordset back to the server?" 
strMarshalModified = "Would you like to send only " & _ 
"modified rows back to the server?" 
If MsgBox(strMessage, vbYesNo) = vbYes Then 
If MsgBox(strMarshalAll, vbYesNo) = vbYes Then 
rstEmployees.MarshalOptions = adMarshalAll 
ElseIf MsgBox(strMarshalModified, vbYesNo) = vbYes Then 
rstEmployees.MarshalOptions = adMarshalModifiedOnly 
End If 
End If 
` Show the resulting data. 
MsgBox "Data in recordset = " & rstEmployees!fname & " " & _ 
` Restore original data because this is a demonstration. 
If Not (strOldFirst = rstEmployees!fname And _ 
strOldLast = rstEmployees!lname) Then 
rstEmployees!fname = strOldFirst 
rstEmployees!lname = strOldLast 
End If
End Sub