ReportingService2010.FireEvent(String, String, String) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
根據所提供的參數引發事件。
public:
void FireEvent(System::String ^ EventType, System::String ^ EventData, System::String ^ SiteUrl);
[System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/FireEvent", 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 FireEvent(string EventType, string EventData, string SiteUrl);
[<System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/FireEvent", 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.FireEvent : string * string * string -> unit
Public Sub FireEvent (EventType As String, EventData As String, SiteUrl As String)
參數
- EventType
- String
事件的名稱。
- EventData
- String
與事件相關的資料。
- 屬性
範例
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;
string site = "http://<Server Name>";
// Get the subscriptions
Subscription[] subs =
rs.ListMySubscriptions(site);
try
{
if (subs != null)
{
// Fire the first subscription in the list
rs.FireEvent("TimedSubscription",
subs[0].SubscriptionID, site);
Console.WriteLine("Event fired.");
}
}
catch (Exception ex)
{
Console.WriteLine(ex.Message);
}
}
}
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 site As String = "http://<Server Name>"
' Get the subscriptions
Dim subs As Subscription() = _
rs.ListSubscriptions(site)
Try
If Not (subs Is Nothing) Then
' Fire the first subscription in the list
rs.FireEvent("TimedSubscription", subs(0).SubscriptionID, site)
Console.WriteLine("Event fired.")
End If
Catch ex As Exception
Console.WriteLine(ex.Message)
End Try
End Sub
End Class
備註
下表顯示此操作的標頭與權限資訊。
| SOAP 標頭的使用 | (在) TrustedUserHeaderValue (出局) ServerInfoHeaderValue |
| 原生模式所需權限 | GenerateEvents (系統) |
| SharePoint 模式 必要權限 | <xref:Microsoft.SharePoint.SPBasePermissions.ManageWeb> |
此方法若在原生模式下參數指定SiteUrl非空值,會拋rsUnsupportedParameterForModeException出例外。
參數 EventType 會與報告伺服器設定檔(rsreportserver.config)中定義的已知事件集合進行匹配。 若事件不在報告伺服器設定檔中,則會拋出帶有錯誤代碼的 rsUnknownEventTypeSOAP 例外。 此方法支援 TimedSubscription 和 RefreshCache 事件類型。
若 EventType ,TimedSubscription則指定 訂閱 ID ,EventData該 ID 由 或 CreateDataDrivenSubscriptionCreateDataDrivenSubscription 返回CreateSubscription。 若 EventType , RefreshCache則指定快取刷新計畫 ID 為 EventData,該 由 返回 CreateCacheRefreshPlan。
該 FireEvent 方法不會驗證或驗證參數中 EventData 提供的資料。 任何字串值皆有效,包括空字串。