NotificationStatus Constructor (NotificationState, Boolean, String, String, Object)

2008-12-15

Creates an instance of the NotificationStatus class, and initializes it with references to a NotificationState, a Boolean value indicating whether the delivery was a success, the delivery status, the notification text, and the delivery date and time. If specifying the notification delivery time, the value must be provided in Universal Time Coordinate (UTC) format.

命名空间: Microsoft.SqlServer.NotificationServices
程序集: Microsoft.SqlServer.NotificationServices (in microsoft.sqlserver.notificationservices.dll)

语法

声明
Public Sub New ( _
    notificationState As NotificationState, _
    succeeded As Boolean, _
    statusInfo As String, _
    notificationText As String, _
    timestamp As Object _
)

public NotificationStatus (
    NotificationState notificationState,
    bool succeeded,
    string statusInfo,
    string notificationText,
    Object timestamp
)

public:
NotificationStatus (
    NotificationState^ notificationState, 
    bool succeeded, 
    String^ statusInfo, 
    String^ notificationText, 
    Object^ timestamp
)

public NotificationStatus (
    NotificationState notificationState, 
    boolean succeeded, 
    String statusInfo, 
    String notificationText, 
    Object timestamp
)

public function NotificationStatus (
    notificationState : NotificationState, 
    succeeded : boolean, 
    statusInfo : String, 
    notificationText : String, 
    timestamp : Object
)

参数

notificationState
A NotificationState object that contains notification information needed by the distributor to correctly interpret the delivery status information. The NotificationState object is passed to the delivery protocol in the DeliverNotification method as part of the NotificationHeaders object. The notificationState cannot be null.

succeeded
A Boolean value that indicates whether the notification was successfully delivered. Can be null if not required.

statusInfo
A String containing any additional notification status information. Can be null or a zero-length string if the delivery protocol has no additional status information to provide.

notificationText
A String containing the formatted notification data that the delivery protocol tried to deliver. Can be null or a zero-length string if the value is not required.

timestamp
An Object representing the time of the delivery attempt. Can be null if the delivery protocol cannot provide the full notification text.

示例

The following examples show how to use a NotificationStatus object in a custom delivery protocol:

private void SendStatus(
    NotificationHeaders[] notificationHeaders,
    bool successfulDelivery,
    string body,
    Exception failureException)
{
    if (null != notificationStatusCallback)
    {
        ArrayList statusList = new ArrayList(
            notificationHeaders.Length);
        string statusInfo;

        // Set some notification status parameters
        // based on delivery success or failure.
        string notificationText;
        if (null == failureException)
        {
            statusInfo = "";
            notificationText = "";
        }
        else
        {
            statusInfo = failureException.Message;
            notificationText = body;
        }

        object timeStamp = DateTime.UtcNow;

        // Create a NotificationStatus object for
        // each notification and add it to an array.
        for (int i = 0; i < notificationHeaders.Length; i++)
        {
            NotificationHeaders notificationHeader = 
                notificationHeaders[i];
            statusList.Add(new NotificationStatus(
                notificationHeader.NotificationState, 
                successfulDelivery, statusInfo, 
                notificationText, timeStamp));
        }

        // Pass the array of NotificationStatus objects
        // to the NotificationStatusCallback delegate.
        notificationStatusCallback(
            (NotificationStatus[])statusList.ToArray(
                typeof(NotificationStatus)));
    }
}