Classe Rule

The Rule object provides programmatic access to a SQL Server rule.

Hiérarchie d'héritage

System.Object
  Microsoft.SqlServer.Management.Smo.SmoObjectBase
    Microsoft.SqlServer.Management.Smo.SqlSmoObject
      Microsoft.SqlServer.Management.Smo.NamedSmoObject
        Microsoft.SqlServer.Management.Smo.ScriptNameObjectBase
          Microsoft.SqlServer.Management.Smo.ScriptSchemaObjectBase
            Microsoft.SqlServer.Management.Smo.DefaultRuleBase
              Microsoft.SqlServer.Management.Smo.Rule

Espace de noms :  Microsoft.SqlServer.Management.Smo
Assembly :  Microsoft.SqlServer.Smo (en Microsoft.SqlServer.Smo.dll)

Syntaxe

'Déclaration
<EvaluationModeAttribute(AutomatedPolicyEvaluationMode.CheckOnSchedule)> _
<PhysicalFacetAttribute(PhysicalFacetOptions.ReadOnly)> _
Public NotInheritable Class Rule _
    Inherits DefaultRuleBase _
    Implements ISfcSupportsDesignMode
'Utilisation
Dim instance As Rule

[EvaluationModeAttribute(AutomatedPolicyEvaluationMode.CheckOnSchedule)]
[PhysicalFacetAttribute(PhysicalFacetOptions.ReadOnly)]
public sealed class Rule : DefaultRuleBase, ISfcSupportsDesignMode

[EvaluationModeAttribute(AutomatedPolicyEvaluationMode::CheckOnSchedule)]
[PhysicalFacetAttribute(PhysicalFacetOptions::ReadOnly)]
public ref class Rule sealed : public DefaultRuleBase, 
    ISfcSupportsDesignMode

[<SealedAttribute>]
[<EvaluationModeAttribute(AutomatedPolicyEvaluationMode.CheckOnSchedule)>]
[<PhysicalFacetAttribute(PhysicalFacetOptions.ReadOnly)>]
type Rule =  
    class 
        inherit DefaultRuleBase 
        interface ISfcSupportsDesignMode 
    end

public final class Rule extends DefaultRuleBase implements ISfcSupportsDesignMode

Le type Rule expose les membres suivants.

Constructeurs

	Nom	Description
	Rule()	Initializes a new instance of the Rule class.
	Rule(Database, String)	Initializes a new instance of the Rule class on the specified database and with the specified name.
	Rule(Database, String, String)	Initializes a new instance of the Rule class on the specified database, with the specified name and schema.

Haut de la page

Propriétés

	Nom	Description
	CreateDate	Gets the time and date when the rule was created.
	DateLastModified	Gets the time and date when the rule was last modified.
	ExtendedProperties	Represents a collection of ExtendedProperty objects. Each ExtendedProperty object represents an extended property on the Default object or the Rule object. (hérité de DefaultRuleBase.)
	ID	Gets the ID value that uniquely identifies the rule.
	Name	Gets or sets the name of the schema. (hérité de ScriptSchemaObjectBase.)
	Parent	Gets or sets the Database object that is the parent of the Rule object.
	Properties	Gets a collection of Property objects that represent the object properties. (hérité de SqlSmoObject.)
	Schema	Gets or sets the schema. (hérité de ScriptSchemaObjectBase.)
	State	Gets the state of the referenced object. (hérité de SmoObjectBase.)
	TextBody	Gets or sets the text that defines the default or rule. (hérité de DefaultRuleBase.)
	TextHeader	Gets or sets the header of the text body that defines the default or rule. (hérité de DefaultRuleBase.)
	TextMode	Gets or sets the Boolean property value that specifies whether the Default object or Rule object header is editable as text. (hérité de DefaultRuleBase.)
	Urn	Gets the Uniform Resource Name (URN) address value that uniquely identifies the object. (hérité de SqlSmoObject.)
	UserData	Gets or sets user-defined data associated with the referenced object. (hérité de SmoObjectBase.)

Haut de la page

Méthodes

	Nom	Description
	Alter	Updates any Default object or Rule object property changes on instance of SQL Server. (hérité de DefaultRuleBase.)
	BindToColumn(String, String)	Binds the default or rule to the specified column in the specified table. (hérité de DefaultRuleBase.)
	BindToColumn(String, String, String)	Binds the default or rule to the specified column in the specified table with the specified schema. (hérité de DefaultRuleBase.)
	BindToDataType	Binds the default or rule to a data type. (hérité de DefaultRuleBase.)
	ChangeSchema	Changes the schema associated with the rule.
	Create	Creates a default or rule on the instance of SQL Server as defined by the Default object or Rule object. (hérité de DefaultRuleBase.)
	Discover	Discovers a list of type Object. (hérité de SqlSmoObject.)
	Drop	Removes the rule or the default. (hérité de DefaultRuleBase.)
	EnumBoundColumns	Enumerates a list of columns to which the default or rule is bound. (hérité de DefaultRuleBase.)
	EnumBoundDataTypes	Enumerates a list of data types to which the default or rule is bound. (hérité de DefaultRuleBase.)
	Equals	(hérité de Object.)
	FormatSqlVariant	Formats an object as SqlVariant type. (hérité de SqlSmoObject.)
	GetContextDB	Gets the context database that is associated with this object. (hérité de SqlSmoObject.)
	GetDBName	Gets the database name that is associated with the object. (hérité de SqlSmoObject.)
	GetHashCode	(hérité de Object.)
	GetPropValue	Gets a property value of the SqlSmoObject object. (hérité de SqlSmoObject.)
	GetPropValueOptional	Gets a property value of the SqlSmoObject object. (hérité de SqlSmoObject.)
	GetPropValueOptionalAllowNull	Gets a property value of the SqlSmoObject object. (hérité de SqlSmoObject.)
	GetServerObject	Gets the server of the SqlSmoObject object. (hérité de SqlSmoObject.)
	GetType	(hérité de Object.)
	Initialize()	Initializes the object and forces the properties be loaded. (hérité de SqlSmoObject.)
	Initialize(Boolean)	Initializes the object and forces the properties be loaded. (hérité de SqlSmoObject.)
	IsObjectInitialized	Verifies whether the object has been initialized. (hérité de SqlSmoObject.)
	IsObjectInSpace	Verifies whether the object is isolated or connected to the instance of SQL Server. (hérité de SqlSmoObject.)
	Refresh	Refreshes the script name. (hérité de ScriptNameObjectBase.)
	Script()	Generates a Transact-SQL script that can be used to re-create the default or rule. (hérité de DefaultRuleBase.)
	Script(ScriptingOptions)	Generates a Transact-SQL script that can be used to re-create the default or rule as specified by the script options. (hérité de DefaultRuleBase.)
	ScriptHeader	Generates a Transact-SQL script that can be used to re-create the default or rule header as specified by the script options. (hérité de DefaultRuleBase.)
	SetParentImpl	Sets the parent of the SqlSmoObject to the newParent parameter. (hérité de SqlSmoObject.)
	ToString	Returns a String that represents the referenced object. (hérité de SqlSmoObject.)
	UnbindFromColumn(String, String)	Unbinds the default or rule from the specified column. (hérité de DefaultRuleBase.)
	UnbindFromColumn(String, String, String)	Unbinds the default or rule from the specified column with the specified table schema. (hérité de DefaultRuleBase.)
	UnbindFromDataType	Unbinds the default or rule from the specified data type (hérité de DefaultRuleBase.)
	Validate	Validates the state of an object. (hérité de SmoObjectBase.)

Haut de la page

Événements

	Nom	Description
	PropertyChanged	Represents the event that occurs when a property is changed. (hérité de SqlSmoObject.)
	PropertyMetadataChanged	Represents the event that occurs when property metadata changes. (hérité de SqlSmoObject.)

Haut de la page

Implémentations d'interfaces explicites

	Nom	Description
	IAlienObject.Discover	Discovers any dependencies. Ne faites pas directement référence à ce membre dans votre code. Il prend en charge l'infrastructure SQL Server. (hérité de SqlSmoObject.)
	IAlienObject.GetDomainRoot	Returns the root of the domain. (hérité de SqlSmoObject.)
	IAlienObject.GetParent	Gets the parent of this object. Ne faites pas directement référence à ce membre dans votre code. Il prend en charge l'infrastructure SQL Server. (hérité de SqlSmoObject.)
	IAlienObject.GetPropertyType	Gets the type of the specified property. (hérité de SqlSmoObject.)
	IAlienObject.GetPropertyValue	Gets the value of the specified property. (hérité de SqlSmoObject.)
	IAlienObject.GetUrn	Gets the Unified Resource Name (URN) of the object. Ne faites pas directement référence à ce membre dans votre code. Il prend en charge l'infrastructure SQL Server. (hérité de SqlSmoObject.)
	IAlienObject.Resolve	Gets the instance that contains the information about the object from the Unified Resource Name (URN) of the object. (hérité de SqlSmoObject.)
	IAlienObject.SetObjectState	Sets the object state to the specified SfcObjectState value. (hérité de SqlSmoObject.)
	IAlienObject.SetPropertyValue	Sets the property value. (hérité de SqlSmoObject.)
	ISfcPropertyProvider.GetPropertySet	Gets the interface reference to the set of properties of this object. (hérité de SqlSmoObject.)
	ISfcSupportsDesignMode.IsDesignMode	Gets a Boolean value that indicates whether the object supports design mode. Identifié à titre d'information uniquement. Non pris en charge. La compatibilité future n'est pas garantie.

Haut de la page

Notes

To get Rule object properties, users can be a member of the public fixed server role.

To set Rule object properties, users must have CREATE RULE permission on the parent database or be a member of the db_owner fixed database role.

To create a rule, users must have CREATE RULE permission on the parent database or be a member of the db_owner fixed database role.

To drop a rule, users must have ALTER permission on the schema to which the rule belongs.

To bind or unbind a rule to a table, users must have ALTER permission on the table.

To bind or unbind a rule to a data type, users must have ALTER permission on the schema to which the data type belongs.

Thread Safety

Tout membre statique public (Partagé dans Microsoft Visual Basic) de ce type est sûr dans le cadre des opérations à plusieurs threads. Tous les membres de l'instance ne sont pas garantis comme étant thread-safe.

Exemples

Création, modification et suppression de règles

Sécurité des threads

Tous les membres publics static (Shared dans Visual Basic) de ce type sont thread-safe. Tous les membres de l'instance ne sont pas garantis comme étant thread-safe.

Voir aussi

Référence

Espace de noms Microsoft.SqlServer.Management.Smo

Autres ressources

Règles

CREATE RULE (Transact-SQL)