Subscription.Condition Property

Articolo
12/15/2008

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

Spazio dei nomi: Microsoft.SqlServer.NotificationServices
Assembly : Microsoft.SqlServer.NotificationServices (in microsoft.sqlserver.notificationservices.dll)

Sintassi

'Dichiarazione
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)

Valore proprietà

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

Osservazioni

[!NOTA] 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 Definizione di azioni condizionali.

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;

Esempio

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.

Piattaforme

Piattaforme di sviluppo

Per un elenco delle piattaforme supportate, vedere Requisiti hardware e software per l'Installazione di SQL Server 2005.

Piattaforme di destinazione

Per un elenco delle piattaforme supportate, vedere Requisiti hardware e software per l'Installazione di SQL Server 2005.

Vedere anche

Riferimento

Subscription Class
Subscription Members
Microsoft.SqlServer.NotificationServices Namespace

Altre risorse

Autorizzazione VIEW DEFINITION

Share via