ReportingService2005.CreateSchedule(String, ScheduleDefinition) Method

Definition

Creates a new shared schedule.

public:
 System::String ^ CreateSchedule(System::String ^ Name, ReportService2005::ScheduleDefinition ^ ScheduleDefinition);
public string CreateSchedule (string Name, ReportService2005.ScheduleDefinition ScheduleDefinition);
member this.CreateSchedule : string * ReportService2005.ScheduleDefinition -> string
Public Function CreateSchedule (Name As String, ScheduleDefinition As ScheduleDefinition) As String

Parameters

Name
String

The name of the schedule.

ScheduleDefinition
ScheduleDefinition

A ScheduleDefinition object that defines the properties and values for the schedule.

Returns

A String value representing the ID of the newly-created schedule.

Examples

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 creates a shared schedule in the report server database that runs every weekday at 2:00 P.M., starting March 3, 2003.

Imports System  
Imports System.Web.Services.Protocols  

Class Sample  
   Public Shared Sub Main()  
      Dim rs As New ReportingService2005()  
      rs.Credentials = System.Net.CredentialCache.DefaultCredentials  

      Dim definition As New ScheduleDefinition()  
      Dim scheduleID As String = ""  

      ' Create the schedule definition.  
      definition.StartDateTime = New DateTime(2003, 3, 1, 14, 0, 0)  
      Dim recurrence As New WeeklyRecurrence()  
      Dim days As New DaysOfWeekSelector()  
      days.Monday = True  
      days.Tuesday = True  
      days.Wednesday = True  
      days.Thursday = True  
      days.Friday = True  
      days.Saturday = False  
      days.Sunday = False  
      recurrence.DaysOfWeek = days  
      recurrence.WeeksInterval = 1  
      recurrence.WeeksIntervalSpecified = True  
      definition.Item = recurrence  

      Try  
         scheduleID = rs.CreateSchedule("My Schedule", definition)  
         Console.WriteLine("Schedule created with ID {0}", scheduleID)  

      Catch e As SoapException  
         Console.WriteLine(e.Detail.InnerXml.ToString())  
      End Try  
   End Sub 'Main  
End Class 'Sample  
using System;  
using System.Web.Services.Protocols;  

class Sample  
{  
   public static void Main()  
   {  
      ReportingService2005 rs = new ReportingService2005();  
      rs.Credentials = System.Net.CredentialCache.DefaultCredentials;  

      ScheduleDefinition definition = new ScheduleDefinition();  
      string scheduleID = "";  

      // Create the schedule definition.  
      definition.StartDateTime = new DateTime(2003, 3, 1, 14, 0, 0);  
      WeeklyRecurrence recurrence = new WeeklyRecurrence();  
      DaysOfWeekSelector days = new DaysOfWeekSelector();  
      days.Monday = true;  
      days.Tuesday = true;  
      days.Wednesday = true;  
      days.Thursday = true;  
      days.Friday = true;  
      days.Saturday = false;  
      days.Sunday = false;  
      recurrence.DaysOfWeek = days;  
      recurrence.WeeksInterval = 1;  
      recurrence.WeeksIntervalSpecified = true;  
      definition.Item = recurrence;  

      try  
      {  
         scheduleID = rs.CreateSchedule("My Schedule", definition);  
         Console.WriteLine("Schedule created with ID {0}", scheduleID);  
      }  

      catch ( SoapException e )  
      {  
         Console.WriteLine(e.Detail.InnerXml.ToString());  
      }  
   }  
}  

Remarks

The table below shows header and permissions information on this operation.

SOAP Headers (In) BatchHeaderValue

(Out) ServerInfoHeaderValue
Required Permissions CreateSchedules (System)

If an error occurs when the CreateSchedule method executes, the schedule is not created and no schedule ID is returned.

Applies to