Condition Class
The Condition object represents a policy-based management condition.
Inheritance Hierarchy
System.Object
Microsoft.SqlServer.Management.Sdk.Sfc.SfcInstance
Microsoft.SqlServer.Management.Dmf.Condition
Namespace: Microsoft.SqlServer.Management.Dmf
Assembly: Microsoft.SqlServer.Dmf (in Microsoft.SqlServer.Dmf.dll)
Syntax
'Declaration
<StrongNameIdentityPermissionAttribute(SecurityAction.LinkDemand, PublicKey := "0024000004800000940000000602000000240000525341310004000001000100272736ad6e5f9586bac2d531eabc3acc666c2f8ec879fa94f8f7b0327d2ff2ed523448f83c3d5c5dd2dfc7bc99c5286b2c125117bf5cbe242b9d41750732b2bdffe649c6efb8e5526d526fdd130095ecdb7bf210809c6cdad8824faa9ac0310ac3cba2aa0523567b2dfa7fe250b30facbd62d4ec99b94ac47c7d3b28f1f6e4c8")> _
Public NotInheritable Class Condition _
Inherits SfcInstance _
Implements ISfcCreatable, ICreatable, ISfcDroppable, IDroppable, _
ISfcAlterable, IAlterable, ISfcRenamable, IRenamable, ISfcValidate
'Usage
Dim instance As Condition
[StrongNameIdentityPermissionAttribute(SecurityAction.LinkDemand, PublicKey = "0024000004800000940000000602000000240000525341310004000001000100272736ad6e5f9586bac2d531eabc3acc666c2f8ec879fa94f8f7b0327d2ff2ed523448f83c3d5c5dd2dfc7bc99c5286b2c125117bf5cbe242b9d41750732b2bdffe649c6efb8e5526d526fdd130095ecdb7bf210809c6cdad8824faa9ac0310ac3cba2aa0523567b2dfa7fe250b30facbd62d4ec99b94ac47c7d3b28f1f6e4c8")]
public sealed class Condition : SfcInstance,
ISfcCreatable, ICreatable, ISfcDroppable, IDroppable, ISfcAlterable,
IAlterable, ISfcRenamable, IRenamable, ISfcValidate
[StrongNameIdentityPermissionAttribute(SecurityAction::LinkDemand, PublicKey = L"0024000004800000940000000602000000240000525341310004000001000100272736ad6e5f9586bac2d531eabc3acc666c2f8ec879fa94f8f7b0327d2ff2ed523448f83c3d5c5dd2dfc7bc99c5286b2c125117bf5cbe242b9d41750732b2bdffe649c6efb8e5526d526fdd130095ecdb7bf210809c6cdad8824faa9ac0310ac3cba2aa0523567b2dfa7fe250b30facbd62d4ec99b94ac47c7d3b28f1f6e4c8")]
public ref class Condition sealed : public SfcInstance,
ISfcCreatable, ICreatable, ISfcDroppable, IDroppable, ISfcAlterable,
IAlterable, ISfcRenamable, IRenamable, ISfcValidate
[<SealedAttribute>]
[<StrongNameIdentityPermissionAttribute(SecurityAction.LinkDemand, PublicKey = "0024000004800000940000000602000000240000525341310004000001000100272736ad6e5f9586bac2d531eabc3acc666c2f8ec879fa94f8f7b0327d2ff2ed523448f83c3d5c5dd2dfc7bc99c5286b2c125117bf5cbe242b9d41750732b2bdffe649c6efb8e5526d526fdd130095ecdb7bf210809c6cdad8824faa9ac0310ac3cba2aa0523567b2dfa7fe250b30facbd62d4ec99b94ac47c7d3b28f1f6e4c8")>]
type Condition =
class
inherit SfcInstance
interface ISfcCreatable
interface ICreatable
interface ISfcDroppable
interface IDroppable
interface ISfcAlterable
interface IAlterable
interface ISfcRenamable
interface IRenamable
interface ISfcValidate
end
public final class Condition extends SfcInstance implements ISfcCreatable, ICreatable, ISfcDroppable, IDroppable, ISfcAlterable, IAlterable, ISfcRenamable, IRenamable, ISfcValidate
The Condition type exposes the following members.
Constructors
| Name | Description | |
|---|---|---|
.gif "Public method") |
Condition() | Initializes a new instance of the Condition class. |
|
Condition(PolicyStore, String) | Initializes a new instance of the Policy class. |
Top
Properties
| Name | Description | |
|---|---|---|
.gif "Protected property") |
AbstractIdentityKey | Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.) |
.gif "Public property") |
CreateDate | Gets the date and time when the condition was created. |
|
CreatedBy | Gets the authentication credentials of the user who created the condition. |
|
DateModified | Gets the date and time when the condition was last modified. |
|
Description | Gets or sets the descriptions of the condition. |
|
ExpressionNode | Gets or sets the type of expression that the condition uses. |
|
Facet | Gets or sets the facet that is associated with the condition. |
|
HasScript | Gets the Boolean value that specifies whether the condition has a script. |
|
ID | Gets the ID value that uniquely identifies the condition. |
|
IdentityKey | Gets the Condition.Key of the condition object. |
|
IsEnumerable | Gets the Boolean value that specifies whether the condition is enumerable. |
|
IsSystemObject | Determines whether the condition is a Object. |
|
Metadata | Returns metadata about the instance and its domain. (Inherited from SfcInstance.) |
|
ModifiedBy | Gets the authentication credentials of the user who last modified the condition. |
|
Name | Gets the name of the facet. |
|
Parent | Gets or sets the object that is the parent of the referenced object. |
|
Properties | Returns a collection instance properties. (Inherited from SfcInstance.) |
|
State | Returns the state of the SfcInstance object. (Inherited from SfcInstance.) |
|
Urn | Returns the uniform resource name of the SfcInstance object. (Inherited from SfcInstance.) |
Top
Methods
| Name | Description | |
|---|---|---|
|
Alter | Updates any Condition object property changes on the instance of SQL Server. |
|
Create | Creates a policy on the instance of SQL Server with the given name, and as defined by the Condition object. |
.gif "Protected method") |
CreateIdentityKey | Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.) |
|
Discover | Discovers the dependencies of the condition. (Overrides SfcInstance.Discover(ISfcDependencyDiscoveryObjectSink).) |
|
Drop | Removes the condition from the instance of SQL Server. |
|
EnumDependentPolicies | Returns a collection of polices that are dependent on the condition. |
|
Equals | (Inherited from Object.) |
|
GetChildCollection | Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.) |
|
GetDomain | Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.) |
|
GetHashCode | (Inherited from Object.) |
.gif "Static member") |
GetObjectFactory | Gets the object factory for the object. |
|
GetPropertySet | Returns the set of properties for the SfcInstance object. (Inherited from SfcInstance.) |
|
GetSupportedEvaluationMode | Gets the evaluation mode for the condition. |
|
GetType | (Inherited from Object.) |
|
GetTypeMetadataImpl | Indicates the domains that override by returning the right TypeMetadata class directly. Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.) |
|
InitializeUIPropertyState | Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.) |
|
OnPropertyMetadataChanges | Invoked whenever the effective value of any SfcInstance metadata is updated. (Inherited from SfcInstance.) |
|
OnPropertyValueChanges | Invoked whenever the effective value of any SfcInstance property is updated. (Inherited from SfcInstance.) |
|
Refresh | Refreshes the object's properties by reading them from the server. (Inherited from SfcInstance.) |
|
Rename | Renames the condition to the specified name. |
|
ResetKey | Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.) |
|
ScriptAlter | Alters the ISfcScript object. |
|
ScriptCreate | Creates an ISfcScript object. |
|
ScriptDrop | Drops the ISfcScript object. |
|
Serialize | Serializes the instance to XML. (Inherited from SfcInstance.) |
|
ToString | Returns a string representation of the instance Urn. (Inherited from SfcInstance.) |
|
Validate | Validates the condition using the given mode. |
Top
Events
| Name | Description | |
|---|---|---|
.gif "Public event") |
PropertyChanged | CLS-compliant event for property changes. (Inherited from SfcInstance.) |
|
PropertyMetadataChanged | CLS-compliant event for property metadata changes. (Inherited from SfcInstance.) |
Top
Explicit Interface Implementations
| Name | Description | |
|---|---|---|
.gif "Explicit interface implemetation") .gif "Private method") |
ISfcRenamable.Rename | Renames the condition identified by the specified SfcKey. |
|
ISfcRenamable.ScriptRename | Renames the script identified by the SfcKey. |
|
ISfcValidate.Validate | Validates a Policy-based Management condition against a specified object using a specified validation method. |
Top
Remarks
A condition is a logical expression that specifies a set of allowed states of a management facet on the target object. The facet is assigned to the condition using the Facet property and the allowed state is applied using a logical expression, specified by the ExpressionNode property. The Transact-SQL expression is assigned to the ExpressionNode object using the Parse(String) method.
Using a Condition object you can:
Create, view, modify and delete a condition.
Specify facets and expressions.
Validate the condition.
Discover the dependencies of the condition.
Enumerate the policies that use the condition.
Examples
Create, View, Modify, and Delete a Policy-Based Management Condition
Thread Safety
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.