Export (0) Print
Expand All

PolicyCategory Class

Represents a category that classifies policies in SQL Server Policy-Based Management. Policy Categories are used to group policies together to which target objects can subscribe.

Object
  Microsoft.SqlServer.Management.Sdk.Sfc.SfcInstance
    Microsoft.SqlServer.Management.Dmf.PolicyCategory

Namespace:  Microsoft.SqlServer.Management.Dmf
Assembly:  Microsoft.SqlServer.Dmf (in Microsoft.SqlServer.Dmf.dll)

[StrongNameIdentityPermissionAttribute(SecurityAction.LinkDemand, PublicKey = "0024000004800000940000000602000000240000525341310004000001000100272736ad6e5f9586bac2d531eabc3acc666c2f8ec879fa94f8f7b0327d2ff2ed523448f83c3d5c5dd2dfc7bc99c5286b2c125117bf5cbe242b9d41750732b2bdffe649c6efb8e5526d526fdd130095ecdb7bf210809c6cdad8824faa9ac0310ac3cba2aa0523567b2dfa7fe250b30facbd62d4ec99b94ac47c7d3b28f1f6e4c8")]
public sealed class PolicyCategory : SfcInstance, 
	ISfcCreatable, ICreatable, ISfcDroppable, IDroppable, ISfcAlterable, 
	IAlterable, ISfcRenamable, IRenamable

The PolicyCategory type exposes the following members.

  NameDescription
Public methodPolicyCategory()Initializes a new instance of the PolicyCategory class.
Public methodPolicyCategory(PolicyStore, String)Initializes a new instance of the PolicyCategory class.
Top

  NameDescription
Protected propertyAbstractIdentityKeyDo not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
Public propertyStatic memberDefaultCategoryGets the category to which the policy is assigned by default.
Public propertyIDGets the ID value that uniquely identifies the policy category.
Public propertyIdentityKeyGets the key that uniquely identifies the policy category.
Public propertyMandateDatabaseSubscriptionsGets or sets the Boolean value that determines whether the database subscriptions are permitted.
Public propertyMetadataReturns metadata about the instance and its domain. (Inherited from SfcInstance.)
Public propertyNameGets the name of the policy category.
Public propertyParentGets or sets the parent instance via the keychain.
Public propertyPropertiesReturns a collection instance properties. (Inherited from SfcInstance.)
Protected propertyStateReturns the state of the SfcInstance object. (Inherited from SfcInstance.)
Public propertyUrnReturns the uniform resource name of the SfcInstance object. (Inherited from SfcInstance.)
Top

  NameDescription
Public methodAlterUpdates any PolicyCategory object property changes on the instance of SQL Server.
Public methodCreateCreates a category for the PolicyCategory class.
Protected methodCreateIdentityKeyDo not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
Public methodDiscoverDo not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
Public methodDropRemoves the policy category from the instance of SQL Server.
Public methodEquals (Inherited from Object.)
Protected methodGetChildCollectionDo not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
Public methodGetDomainDo not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
Public methodGetHashCode (Inherited from Object.)
Public methodStatic memberGetObjectFactoryGets the object factory for the object.
Public methodGetPropertySetReturns the set of properties for the SfcInstance object. (Inherited from SfcInstance.)
Public methodGetType (Inherited from Object.)
Protected methodGetTypeMetadataImplIndicates 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.)
Protected methodInitializeUIPropertyStateDo not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
Protected methodOnPropertyMetadataChangesInvoked whenever the effective value of any SfcInstance metadata is updated. (Inherited from SfcInstance.)
Protected methodOnPropertyValueChangesInvoked whenever the effective value of any SfcInstance property is updated. (Inherited from SfcInstance.)
Public methodRefreshRefreshes the object's properties by reading them from the server. (Inherited from SfcInstance.)
Public methodRenameRenames the policy.
Protected methodResetKeyDo not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
Public methodSerializeSerializes the instance to XML. (Inherited from SfcInstance.)
Public methodToStringReturns a string representation of the instance Urn. (Inherited from SfcInstance.)
Top

  NameDescription
Public eventPropertyChangedCLS-compliant event for property changes. (Inherited from SfcInstance.)
Public eventPropertyMetadataChangedCLS-compliant event for property metadata changes. (Inherited from SfcInstance.)
Top

  NameDescription
Explicit interface implemetationPrivate methodISfcAlterable.ScriptAlterAlters the script that is used to create the policy. Do not reference this member directly in your code. It supports the SQL Server infrastructure..
Explicit interface implemetationPrivate methodISfcCreatable.ScriptCreateCreates a script that is used to create the policy. Do not reference this member directly in your code. It supports the SQL Server infrastructure..
Explicit interface implemetationPrivate methodISfcDroppable.ScriptDropDrops the script that is used to create the policy. Do not reference this member directly in your code. It supports the SQL Server infrastructure.
Explicit interface implemetationPrivate methodISfcRenamable.RenameRenames the policy with the specified key.
Explicit interface implemetationPrivate methodISfcRenamable.ScriptRenameRenames the script that is used to create the policy with the specified key.
Top

Using the PolicyCategory object you can:

  • Create a policy category to which target objects can subscribe.

  • Specify the policy category to use in a subscription

C#

PolicyCategorySubscription policyCatSub = new PolicyCategorySubscription(ps);
policyCatSub.PolicyCategory = category;
policyCatSub.TargetType = targetType;
policyCatSub.Target = targetObject;
policyCatSub.Create();

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft