語言

ReportingService2010.CreateSchedule 方法

定義

建立新的共享排程。

public:
 System::String ^ CreateSchedule(System::String ^ Name, ReportService2010::ScheduleDefinition ^ ScheduleDefinition, System::String ^ SiteUrl);
[System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/CreateSchedule", ParameterStyle=System.Web.Services.Protocols.SoapParameterStyle.Wrapped, RequestNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", ResponseNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", Use=System.Web.Services.Description.SoapBindingUse.Literal)]
[System.Web.Services.Protocols.SoapHeader("TrustedUserHeaderValue")]
[System.Web.Services.Protocols.SoapHeader("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)]
public string CreateSchedule(string Name, ReportService2010.ScheduleDefinition ScheduleDefinition, string SiteUrl);
[<System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/CreateSchedule", ParameterStyle=System.Web.Services.Protocols.SoapParameterStyle.Wrapped, RequestNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", ResponseNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", Use=System.Web.Services.Description.SoapBindingUse.Literal)>]
[<System.Web.Services.Protocols.SoapHeader("TrustedUserHeaderValue")>]
[<System.Web.Services.Protocols.SoapHeader("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)>]
member this.CreateSchedule : string * ReportService2010.ScheduleDefinition * string -> string
Public Function CreateSchedule (Name As String, ScheduleDefinition As ScheduleDefinition, SiteUrl As String) As String

參數

Name
String

排程的名稱。

ScheduleDefinition
ScheduleDefinition

一個 ScheduleDefinition 定義排程屬性與值的物件。

SiteUrl
String

這是 SharePoint 網站的完整 URL 。

在 Native 模式下呼叫此方法時,請將此參數設為 null (Nothing在 Visual Basic 中)。

傳回

一個 String 代表新建立排程 ID 的值。

屬性

範例

using System;  
using System.Collections.Generic;  
using System.IO;  
using System.Text;  
using System.Web;  
using System.Web.Services;  
using System.Web.Services.Protocols;  

class Sample  
{  
    static void Main(string[] args)  
    {  
        ReportingService2010 rs = new ReportingService2010();  
        rs.Url = "http://<Server Name>" +  
            "/_vti_bin/ReportServer/ReportService2010.asmx";  
        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  
        {  
            string site = "http://<Server Name>";  

            scheduleID = rs.CreateSchedule("My Schedule",   
                definition, site);  
            Console.WriteLine("Schedule created with ID {0}",   
                scheduleID);  
        }  
        catch (SoapException e)  
        {  
            Console.WriteLine(e.Detail.InnerXml.ToString());  
        }  
    }  
}  
Imports System  
Imports System.IO  
Imports System.Text  
Imports System.Web.Services  
Imports System.Web.Services.Protocols  

Class Sample  

    Public Shared Sub Main()  

        Dim rs As New ReportingService2010()  
        rs.Url = "http://<Server Name>" + _  
            "/_vti_bin/ReportServer/ReportService2010.asmx"  
        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()a  
        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  
            Dim site As String = "http://<Server Name>"  

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

        Catch e As SoapException  
            Console.WriteLine(e.Detail.InnerXml.ToString())  
        End Try  

    End Sub  

End Class  

備註

下表顯示此操作的標頭與權限資訊。

SOAP 標頭的使用 (在) TrustedUserHeaderValue

(出局) ServerInfoHeaderValue
原生模式所需權限 CreateSchedules (系統)
SharePoint 模式 必要權限 <xref:Microsoft.SharePoint.SPBasePermissions.ManageWeb>

此方法若在原生模式下參數指定SiteUrl非空值,會拋rsUnsupportedParameterForModeException出例外。

若執行時 CreateSchedule 發生錯誤,則不會建立排程,且不會回傳排程 ID。

該MonthlyDOWRecurrence圖案在 SharePoint 整合模式下不支援。

適用於