ReportingService2010.SetSubscriptionProperties 方法

  • 参考

定义

命名空间:
ReportService2010
程序集:
ReportService2010.dll

设置订阅的属性。

public:
 void SetSubscriptionProperties(System::String ^ SubscriptionID, ReportService2010::ExtensionSettings ^ ExtensionSettings, System::String ^ Description, System::String ^ EventType, System::String ^ MatchData, cli::array <ReportService2010::ParameterValue ^> ^ Parameters);
[System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/SetSubscriptionProperties", 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("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)]
[System.Web.Services.Protocols.SoapHeader("TrustedUserHeaderValue")]
public void SetSubscriptionProperties (string SubscriptionID, ReportService2010.ExtensionSettings ExtensionSettings, string Description, string EventType, string MatchData, ReportService2010.ParameterValue[] Parameters);
[<System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/SetSubscriptionProperties", 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("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)>]
[<System.Web.Services.Protocols.SoapHeader("TrustedUserHeaderValue")>]
member this.SetSubscriptionProperties : string * ReportService2010.ExtensionSettings * string * string * string * ReportService2010.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 对象的数组，它包含用于报表的参数的列表。

属性
SoapDocumentMethodAttribute SoapHeaderAttribute

注解

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

(Out) ServerInfoHeaderValue
本机模式所需的权限 UpdateAnySubscription 或者 (UpdateSubscription 用户是报表所有者，订阅是定时订阅)
SharePoint 模式所需权限 <xref:Microsoft.SharePoint.SPBasePermissions.ManageAlerts> 或者 (<xref:Microsoft.SharePoint.SPBasePermissions.CreateAlerts> 用户是订阅所有者，订阅是计时订阅)

参数的值 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 中将参数设置为 MatchDatanull (。

SharePoint 用户信息中的 SharePoint 非管理用户的“工作电子邮件”属性应为 TO 电子邮件传递扩展插件设置

适用于