Subscription.Condition Property

Article
12/03/2008

Gets or sets the condition. This property is used for subscription classes that contain condition actions.

Namespace: Microsoft.SqlServer.NotificationServices
Assembly: Microsoft.SqlServer.NotificationServices (in microsoft.sqlserver.notificationservices.dll)

Syntax

'Declaration
Public Property Condition As Condition

public Condition Condition { get; set; }

public:
property Condition^ Condition {
    Condition^ get ();
    void set (Condition^ value);
}

/** @property */
public Condition get_Condition ()

/** @property */
public void set_Condition (Condition value)

public function get Condition () : Condition

public function set Condition (value : Condition)

Property Value

A Microsoft.SqlServer.NotificationServices.Rules.Condition object that specifies the conditions for the subscription.

Remarks

Note

This method does not support COM interop.

In SQL Server 2000 Notification Services, subscribers created subscriptions by defining parameter values for pre-defined queries. In SQL Server 2005 Notification Services, your subscription classes can have condition actions, which allow subscribers to define more complex conditions.

A single subscription class can support parameter-based actions and condition actions. Subscriptions that use condition actions must have both of the Condition and RuleName properties. Subscriptions that do not use condition actions must have neither of these properties.

For more information about conditions, see Defining Condition Actions.

The subscription management interface must have VIEW DEFINITION permissions on the objects referenced in the condition. The objects typically are the Input tables and views and any user-defined functions used by the conditions. For example, if your subscription management interface runs under NSTestUser, you can grant permissions on the Sales.Customer view and then dbo.ufnGetAccountEndDate user-defined function using the following Transact-SQL statements:

GRANT VIEW DEFINITION ON Sales.Customer TO NSTestUser;
GRANT VIEW DEFINITION ON dbo.ufnGetAccountingEndDate TO NSTestUser;

Example

The following example shows how to define a condition for a subscription.

' Create the NSInstance object.
Dim testInstance As New NSInstance("InventoryTrackerInstance")
 
' Create the NSApplication object.
Dim testApplication As _
    New NSApplication(testInstance, "InventoryTracker")
 
' Define subscription properties
Dim s As New Subscription( _
    testApplication, "InventoryTrackerSubscriptions")
s.SubscriberId = "TestUser1"
s.Enabled = True
s.RuleName = "InventoryTrackerRule"
s("DeviceName") = "Work e-mail"
s("SubscriberLocale") = "en-US"
 
' Define OrCondition
s.Condition = New OrCondition( _
    New SimpleLeafCondition( _
        New FieldValue("Quantity"), _
        SimpleOperator.GreaterThanOrEqualTo, _
        500), _
    New SimpleLeafCondition( _
        New FieldValue("Quantity"), _
        SimpleOperator.LessThanOrEqualTo, _
        35))
 
' Add subscription
s.Add()

// Create the NSInstance object.
NSInstance testInstance =
    new NSInstance("InventoryTrackerInstance");

// Create the NSApplication object.
NSApplication testApplication =
    new NSApplication(testInstance, "InventoryTracker");

// Define subscription properties
Subscription s = new Subscription(testApplication, "InventoryTrackerSubscriptions");
s.SubscriberId = "TestUser1";
s.Enabled = true;
s.RuleName = "InventoryTrackerRule";
s["DeviceName"] = "Work e-mail";
s["SubscriberLocale"] = "en-US";

// Define OrCondition
s.Condition = new OrCondition(
    new SimpleLeafCondition(new FieldValue("Quantity"),
        SimpleOperator.GreaterThanOrEqualTo,
        500),
    new SimpleLeafCondition(new FieldValue("Quantity"),
        SimpleOperator.LessThanOrEqualTo,
        35)
);

// Add subscription
s.Add();

Thread Safety

Any public static (Shared in Microsoft Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005.

Target Platforms