ReportingService2005.CreateSchedule(String, ScheduleDefinition) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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.