MultipleColumnUpdate Property

  • Article

This feature will be removed in a future version of Microsoft SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature.

The MultipleColumnUpdate property specifies whether to update multiple columns using a single UPDATE statement.

Syntax

object.MultipleColumnUpdate [= value]

Parts

  • object
    An expression that evaluates to an object in the Applies To list
  • value
    TRUE or FALSE

Data Type

Boolean

Modifiable

Read/write

Prototype (C/C++)

HRESULT GetMultipleColumnUpdate(LPBOOL pRetVal);
HRESULT SetMultipleColumnUpdate(BOOL NewValue);

Remarks

If set to TRUE (the default), MultipleColumnUpdate specifies that multiple columns are updated using a single UPDATE statement. If MultipleColumnUpdate is set to FALSE, separate update statements are generated for each column changed.

Setting MultipleColumnUpdate to TRUE can result in an increase in performance. An application should set MultipleColumnUpdate to FALSE if it is necessary to maintain compatibility SQL Server 7.0 or earlier. An application should also set MultipleColumnUpdate to FALSE if triggers are defined for one or more columns.

MultipleColumnUpdate cannot be modified after the MergeArticle2 object is created.

Note

If an application calls MultipleColumnUpdate on an instance of SQL Server version 7.0, the constant, SQLDMO_E_SQL80ONLY, and the message "This property or method requires Microsoft SQL Server 2000 or later" are returned.

Applies To:

MergeArticle2 Object