Share via

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

订阅 ID。

ExtensionSettings
ExtensionSettings

一个 ExtensionSettings 对象，该对象包含特定于传递扩展插件的设置的列表。

Description
String

向用户显示的贴切描述。

EventType
String

触发订阅的事件的类型。

MatchData
String

与指定类型的事件关联的数据。 此数据由事件处理扩展插件使用，用来将订阅与已经激发的事件进行匹配。

Parameters
ParameterValue[]

ParameterValue 对象的数组，它包含用于报表的参数的列表。

注解

下表显示了有关此操作的标头和权限信息。
SOAP 标头 (In) BatchHeaderValue

(Out) ServerInfoHeaderValue
所需的权限 UpdateAnySubscription 或者， (UpdateSubscription 用户是报表所有者，订阅是定时订阅)

参数的值 EventType 必须与报表服务器上配置的事件处理扩展插件相对应。 如果事件类型不由事件处理扩展插件处理，则会引发 SOAP 异常，错误代码 rsInvalidEvent为 。 事件类型必须由创建通知的事件处理扩展插件处理。 收到 参数的值 EventType 时，将查询事件处理扩展插件以确定事件是否创建通知。 否则，将引发 SOAP 异常，错误代码 rsEventNonSubscribeable为 。

参数的值 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>

作为 XML 字符串传递的 StartDateTime 元素的值应对应于日期格式 ISO 8601。 此国际日期和时间标准是扩展格式 CCYY-MM-DDThh：mm：ss+/-Z，其中“CC”表示世纪，“YY”表示年份，“MM”表示月份和“DD”日。 字母“T”是日期和时间分隔符，“hh”、“mm”、“ss”分别表示小时、分钟和秒。 此表示形式可能紧跟“Z”，表示协调世界时 (UTC) 。 为了指示时区（表示为本地时间与协调世界时之间的差），“Z”前面是一个“+”或“-”符号，后跟表示为 hh：mm 的 UTC 的差值。

如果 TimedSubscription 的计划定义是共享计划，则必须将共享计划的计划 ID 作为 MatchData 参数传递。 计划 ID 作为 String传递，例如“4608ac1b-fc75-4149-9e15-5a8b5781b843”。 可以通过调用 ListSchedules 方法获取计划 ID。

如果事件是快照更新订阅，请在 Visual Basic) Nothing 中将 null 参数设置为 MatchData (。

适用于