語言

ReportingService2005.SetSubscriptionProperties 方法

定義

命名空間:
ReportService2005
組件:
ReportService2005.dll

設定訂閱的屬性。

public:
 void SetSubscriptionProperties(System::String ^ SubscriptionID, ReportService2005::ExtensionSettings ^ ExtensionSettings, System::String ^ Description, System::String ^ EventType, System::String ^ MatchData, cli::array <ReportService2005::ParameterValue ^> ^ Parameters);
public void SetSubscriptionProperties(string SubscriptionID, ReportService2005.ExtensionSettings ExtensionSettings, string Description, string EventType, string MatchData, ReportService2005.ParameterValue[] Parameters);
member this.SetSubscriptionProperties : string * ReportService2005.ExtensionSettings * string * string * string * ReportService2005.ParameterValue[] -> unit
Public Sub SetSubscriptionProperties (SubscriptionID As String, ExtensionSettings As ExtensionSettings, Description As String, EventType As String, MatchData As String, Parameters As ParameterValue())

參數

SubscriptionID
String

訂用帳戶的標識碼。

ExtensionSettings
ExtensionSettings

一個 ExtensionSettings 包含特定於交付擴充功能的設定清單的物件。

Description
String

一個有意義的描述，會顯示給使用者。

EventType
String

觸發訂閱的事件類型。

MatchData
String

與指定事件類型相關的資料。 這些資料會被事件處理擴充功能用來將訂閱與已觸發事件匹配。

Parameters
ParameterValue[]

一個包含報告參數清單的物件陣列 ParameterValue 。

備註

下表顯示此操作的標頭與權限資訊。
SOAP 標頭 （在） BatchHeaderValue

（出局） ServerInfoHeaderValue
必要權限 UpdateAnySubscription 或者（UpdateSubscription 且使用者是報告擁有者，訂閱是限時訂閱）

參數的 EventType 值必須對應於報告伺服器上設定的事件處理擴充功能。 若事件類型未被事件處理擴充套件處理，則會拋出帶有錯誤碼 rsInvalidEvent的 SOAP 例外。 事件類型必須由產生通知的事件處理擴充功能來處理。 當收到參數值 EventType 時，會查詢事件處理擴充功能以判斷該事件是否會產生通知。 若不符合，則會拋出帶有錯誤碼 rsEventNonSubscribeable的 SOAP 例外。

參數的 MatchData 值取決於事件類型。 若事件為 TimedSubscription 事件，則需以 ScheduleDefinition 物件作為 MatchData 參數。 你必須先將物件序列化 ScheduleDefinition 為 XML，然後以字串值傳遞，並根據排程建立訂閱。 XML 結構可能如下範例所示：

<ScheduleDefinition>  
   <WeeklyRecurrence>  
      <StartDateTime>2003-02-24T09:00:00-08:00</StartDateTime>  
      <WeeksInterval>1</WeeksInterval>  
      <DaysOfWeek>  
         <Monday>True</Monday>  
         </DaysOfWeek>  
   </WeeklyRecurrence>  
</ScheduleDefinition>

當 StartDateTime 元素以 XML 字串傳遞時，其值應對應日期格式 ISO 8601。 此國際日期與時間標準為擴展格式 CCYY-MM-DDThh：mm：ss+/-Z，其中「CC」代表世紀，「YY」代表年份，「MM」代表月份，「DD」代表日。 字母「T」代表日期與時間分隔符，「hh」、「mm」、「ss」分別代表時、分鐘和秒。 此表示法後可緊接「Z」以表示協調世界時（UTC）。 為了表示時區，以當地時間與協調世界時的差值表示，「Z」前會加上「+」或「-」符號，接著是與UTC的差值，表示為hh：mm。

如果 TimedSubscription 的排程定義是共享排程，你必須將共享排程的排程 ID 作為 MatchData 參數傳遞。 Schedule ID 會以 String，例如「4608ac1b-fc75-4149-9e15-5a8b5781b843」傳遞。 可透過呼叫該 ListSchedules 方法取得排程 ID。

如果事件是快照更新訂閱，請在 Visual Basic 中將參數設MatchData為 null （Nothing）。

適用於