Updates the values of records in the current recordset, after the current record, that satisfy the specified filter expression.
[Visual Basic]Overloads Public Function UpdateRecords( _
ByVal records As DataSet, _
ByVal filterExpression As String _
) As Integer
Parameters
- records
- Specifes one or more name-value pairs for the record elements to be updated.
- filterExpression
- Specifies an expression that qualifies the records to be updated. See the Remarks section for details.
Return Value
This method returns the number of records updated.
Remarks
Using Filter Expressions
Some of the methods in the .NET connector allow you to use filter expressions when fetching records from a recordset. The syntax you can use to build filter expressions is:
condition_statement=condition_expression
You can use expressions on both the left and right sides of the condition statement. Be sure to enclose data in quotation marks.
Condition Expressions
AND | condition_expression AND condition_expression |
OR | condition_expression OR condition_expression |
NOT | NOT condition_expression |
Equal to | value_expression = value_expression |
Equal to (case insensitive) | value_expression =* value_expression |
Not equal to | value_expression <> value_expression |
Less than | value_expression < value_expression |
Greater than | value_expression > value_expression |
Less than or equal to | value_expression <= value_expression |
Greater than or equal to | value_expression >= value_expression ( ) (multiple condition_expressions) |
Value Expressions
A value expression can take any of the following:
- Variable (variables.variablename)
- Attribute (attribute name)
- Field (recordset.recordsetfield)
- String
- Integer
- Floating point number
Filter Expression Examples
This example returns all records in the patients recordset that are not "Smith":
patients.lastname <> "Smith"
This example returns the exact same set of records as the preceding example:
NOT (patients.lastname = "Smith")
This example returns all records in the SearchResults recordset with the last name "Smith" and first name "Steven":
(SearchResults.LastName = "Smith") and (SearchResults.FirstName =* "Steven")
This example returns all fields in the AccountNumbers recordset greater than or equal to 10000 and less than or equal to 20000:
(AccountNumbers.Accounts >= 10000) and (AccountNumbers.Accounts <= 20000)
See Also
HostIntegratorSession Class | HostIntegratorSession Members | WRQ.Verastream.HostIntegrator Namespace | HostIntegratorSession.UpdateRecords Overload List