System.Data 2.0.0.0 System.Object

This class provides low-level access to the query notification services exposed by SQL Server 2005. For most applications the class provides a simpler way of using query notifications. However, if you need fine control over when notifications occur, or you need to customize the message data returned as part of a notification, the class is the one to use.

Represents a request for notification for a given command.

- Constructor

  If the default constructor is used to create a object, that instance must have its and properties initialized before assigning the object to a object's property. The default values used by the constructor are NULL (Nothing in Visual Basic) for the , an empty string for the , and zero for the .

  Creates a new instance of the class with default values.

  2.0.0.0
- Constructor

  This constructor allows you to initialize a new instance, providing your own identifier, the SQL Server 2005 Service Broker service name, and a time-out value.

  Creates a new instance of the class with a user-defined string that identifies a particular notification request, the name of a predefined SQL Server 2005 Service Broker service name, and the time-out period, measured in seconds.

  A string that contains an application-specific identifier for this notification. It is not used by the notifications infrastructure, but it allows you to associate notifications with the application state. The value indicated in this parameter is included in the Service Broker queue message.
  A string that contains the Service Broker service name where notification messages are posted, and it must include a database name or a Service Broker instance GUID that restricts the scope of the service name lookup to a particular database.
  The time, in seconds, to wait for a notification message.
  2.0.0.0
- Property
  System.String To be added.

  The value of the property has the following format:

  service=<service-name>{;(local database=<database>|broker instance=<broker instance>)}

  For example, if you use the service "myservice" in the database "AdventureWorks" the format is:

  service=myservice;local database=AdventureWorks

  The SQL Server Service Broker service must be previously configured on the server. In addition, a Service Broker service and queue must be defined and security access granted as needed. See the SQL Server 2005 documentation for more information.

  Gets or sets the SQL Server Service Broker service name where notification messages are posted.

  2.0.0.0
- Property
  System.Int32 To be added.

  After the time-out period expires, the notification is sent even if no change takes place. The property defaults to the value set on the server.

  Gets or sets a value that specifies how long SQL Server waits for a change to occur before the operation times out.

  2.0.0.0
- Property
  System.String To be added.

  This value is not used by the notifications infrastructure. Instead, it is a mechanism that allows an application to associate notifications with application state. The value specified in the property is included in the SQL Server 2005 queue message.

  Gets or sets an application-specific identifier for this notification.

  2.0.0.0