Rule Object (SQL-DMO)

The Rule object exposes the attributes of a single Microsoft® SQL Server™ data-integrity rule.

Remarks

SQL Server offers several mechanisms for ensuring data integrity. A SQL Server rule is a Transact-SQL condition_expression syntax element that defines a data-integrity constraint. A rule can be bound to a column or user-defined data type. condition_expression is executed to validate data for a single column when a value is inserted into the column bound by the rule. For more information, see CREATE RULE.

With the Rule object, you can:

The Name property of a Rule object uses the SQL Server data type sysname. The value of the Name property must be unique for a database.

After you have created the rule, use the BindToColumn and BindToDatatype methods of the Rule object to apply the constraint to SQL Server columns and user-defined data types.

To create a SQL Server rule

  1. Create a Rule object.
  2. Set the Name property.
  3. Set the Text property with the Transact-SQL script validating data integrity for the columns bound by the rule.
  4. Add the Rule object to the Rules collection of a connected Database object.

To remove a rule from a SQL Server database

  1. Get the referring Rule object from the Rules collection of a connected Database object.
  2. Use the ListBoundColumns and ListBoundDatatypes methods to determine affected SQL Server columns and user-defined data types.
  3. Use the UnbindFromColumn and UnbindFromDatatype methods to remove the constraint from columns and user-defined data types bound by the rule.
  4. Use the Remove method of the Rule object to remove it from the SQL Server database.
Methods
BindToColumn Method Remove Method (Objects)
BindToDatatype Method Script Method
ListBoundColumns Method UnbindFromColumn Method
ListBoundDatatypes Method UnbindFromDatatype Method

Properties
CreateDate Property Owner Property (Database Objects)
ID Property Text Property
Name Property  


(c) 1988-98 Microsoft Corporation. All Rights Reserved.