Sun Chili!Soft ASP Sun Chili!Soft
ASP Sun Microsystems


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

Copyright 2002 Sun Microsystems, Inc. All rights reserved. Legal Notice.