ReportingService2005.SetSubscriptionProperties 方法

参考

定义

命名空间:: ReportService2005

程序集:: ReportService2005.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

设置订阅的属性。

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 (。

适用于

通过

ReportingService2005.SetSubscriptionProperties 方法

定义

参数

注解

适用于

其他资源