ReportingService2005.FireEvent Method (ReportService2005)

Other versions are also available for the following:

SQL Server 2005

ReportingService2005.FireEvent Method

[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]

Triggers an event based on the supplied parameters.

Syntax

Visual Basic (Declaration)

Public Sub FireEvent ( _
    EventType As String, _
    EventData As String _
)

public void FireEvent (
    string EventType,
    string EventData
)

C++

public:
void FireEvent (
    String^ EventType, 
    String^ EventData
)

public void FireEvent (
    String EventType, 
    String EventData
)

JScript

public function FireEvent (
    EventType : String, 
    EventData : String
)

Parameters

EventType: The name of the event.

EventData: The data that is associated with the event.

Remarks

The EventType parameter is matched against the known set of events that are defined in the report server configuration file. If the event is not in the report server configuration file, a SOAP exception is thrown with an error code of rsUnknownEventType. The FireEvent method only supports firing the TimedSubscription event type.

The FireEvent method does not verify or validate the data supplied in the EventData parameter. Any string value is valid, including an empty string.

Example

To compile this code example, you must reference the Reporting Services WSDL and import certain namespaces. For more information, see Compiling and Running Code Examples. The following code example searches the report server database for all reports whose names contain the word "Sales":

Visual Basic

Imports System

Class Sample

   Public Shared Sub Main()
      Dim rs As New ReportingService2005()
      rs.Credentials = System.Net.CredentialCache.DefaultCredentials
      ' Get the subscriptions
      Dim subs As Subscription() = rs.ListSubscriptions("/SampleReports/Company Sales", Nothing)

      Try
         If Not (subs Is Nothing) Then
            ' Fire the first subscription in the list
            rs.FireEvent("TimedSubscription", subs(0).SubscriptionID)
            Console.WriteLine("Event fired.")
         End If
      Catch ex As Exception
         Console.WriteLine(ex.Message)
      End Try
   End Sub 'Main
End Class 'Sample

using System;

class Sample
{
   public static void Main()
   {
      ReportingService2005 rs = new ReportingService2005();
      rs.Credentials = System.Net.CredentialCache.DefaultCredentials;
      // Get the subscriptions
      Subscription[] subs = rs.ListSubscriptions("/SampleReports/Company Sales", null);

      try
      {
         if (subs != null)
         {
            // Fire the first subscription in the list
            rs.FireEvent("TimedSubscription", subs[0].SubscriptionID);
            Console.WriteLine("Event fired.");
         }
      }
      catch (Exception ex)
      {
         Console.WriteLine(ex.Message);
      }
   }
}

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.

Target Platforms

Reference

ReportingService2005 Class
ReportingService2005 Members
Microsoft.WSSUX.ReportingServicesWebService.RSManagementService2005 Namespace