ReportingService2005.GetSubscriptionProperties 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
回傳指定訂閱的屬性。
public:
System::String ^ GetSubscriptionProperties(System::String ^ SubscriptionID, [Runtime::InteropServices::Out] ReportService2005::ExtensionSettings ^ % ExtensionSettings, [Runtime::InteropServices::Out] System::String ^ % Description, [Runtime::InteropServices::Out] ReportService2005::ActiveState ^ % Active, [Runtime::InteropServices::Out] System::String ^ % Status, [Runtime::InteropServices::Out] System::String ^ % EventType, [Runtime::InteropServices::Out] System::String ^ % MatchData, [Runtime::InteropServices::Out] cli::array <ReportService2005::ParameterValue ^> ^ % Parameters);
public string GetSubscriptionProperties(string SubscriptionID, out ReportService2005.ExtensionSettings ExtensionSettings, out string Description, out ReportService2005.ActiveState Active, out string Status, out string EventType, out string MatchData, out ReportService2005.ParameterValue[] Parameters);
member this.GetSubscriptionProperties : string * ExtensionSettings * string * ActiveState * string * string * string * ParameterValue[] -> string
Public Function GetSubscriptionProperties (SubscriptionID As String, ByRef ExtensionSettings As ExtensionSettings, ByRef Description As String, ByRef Active As ActiveState, ByRef Status As String, ByRef EventType As String, ByRef MatchData As String, ByRef Parameters As ParameterValue()) As String
參數
- SubscriptionID
- String
訂用帳戶的標識碼。
- ExtensionSettings
- ExtensionSettings
[出]一個 ExtensionSettings 包含特定於交付擴充功能的設定清單的物件。
- Description
- String
[出]一個有意義的描述,會顯示給使用者。
- Active
- ActiveState
[出]一個 ActiveState 包含訂閱有效狀態的物件。
- Status
- String
[出]訂閱狀態。
- EventType
- String
[出]觸發訂閱的事件類型。
- MatchData
- String
[出]與指定事件類型相關的資料。 事件處理擴充功能會用此方式將訂閱與已觸發的事件匹配。
- Parameters
- ParameterValue[]
[出]一個包含報告參數清單的物件陣列 ParameterValue 。
傳回
訂閱擁有者的使用者ID。
範例
要編譯此程式碼範例,您必須參考 Reporting Services WSDL 並匯入特定命名空間。 欲了解更多資訊,請參閱編 譯與執行程式碼範例。 以下程式碼範例使用此 GetSubscriptionProperties 方法,取得產品目錄報告其中一個訂閱的屬性,該報表由使用者 myDomain\myUserName 擁有。 訂閱並非以資料驅動,因此程式碼假設所有交付擴充的設定都是靜態參數值(ParameterValue 物件):
Imports System
Imports System.Web.Services.Protocols
Class Sample
Public Shared Sub Main()
Dim rs As New ReportingService2005()
rs.Credentials = System.Net.CredentialCache.DefaultCredentials
Dim extSettings As ExtensionSettings
Dim desc As String
Dim active As ActiveState
Dim status As String
Dim eventType As String
Dim matchData As String
Dim values As ParameterValue() = Nothing
Dim subscriptions As Subscription() = Nothing
Dim extensionParams As ParameterValueOrFieldReference() = Nothing
Try
subscriptions = rs.ListSubscriptions("/SampleReports/Employee Sales Summary", "Domain\username")
If Not (subscriptions Is Nothing) Then
rs.GetSubscriptionProperties(subscriptions(0).SubscriptionID, extSettings, desc, active, status, eventType, matchData, values)
Console.WriteLine("Description: {0}", desc)
Console.WriteLine("Status: {0}", status)
Console.WriteLine("EventType: {0}", eventType)
Console.WriteLine("matchData: {0}", matchData)
Console.WriteLine("Extension: {0}", extSettings.Extension)
extensionParams = extSettings.ParameterValues
If Not (extensionParams Is Nothing) Then
Dim extensionParam As ParameterValueOrFieldReference
For Each extensionParam In extensionParams
Console.WriteLine((CType(extensionParam, ParameterValue).Name + ": " + CType(extensionParam, ParameterValue).Value))
Next extensionParam
End If
If Not (values Is Nothing) Then
Dim pv As ParameterValue
For Each pv In values
Console.WriteLine("Name: {0}", pv.Name)
Console.WriteLine("Value: {0}", pv.Value)
Next pv
End If
End If
Catch e As SoapException
Console.WriteLine(e.Detail.InnerXml.ToString())
End Try
End Sub 'Main
End Class 'Sample
using System;
using System.Web.Services.Protocols;
class Sample
{
public static void Main()
{
ReportingService2005 rs = new ReportingService2005();
rs.Credentials = System.Net.CredentialCache.DefaultCredentials;
ExtensionSettings extSettings;
string desc;
ActiveState active;
string status;
string eventType;
string matchData;
ParameterValue[] values = null;
Subscription[] subscriptions = null;
ParameterValueOrFieldReference[] extensionParams = null;
try
{
subscriptions = rs.ListSubscriptions( "/SampleReports/Employee Sales Summary", "Domain\\username" );
if ( subscriptions != null )
{
rs.GetSubscriptionProperties( subscriptions[0].SubscriptionID, name, out extSettings, out desc, out active, out status, out eventType, out matchData, out values );
Console.WriteLine( "Description: {0}", desc );
Console.WriteLine( "Status: {0}", status );
Console.WriteLine( "EventType: {0}", eventType );
Console.WriteLine( "matchData: {0}", matchData );
Console.WriteLine( "Extension: {0}", extSettings.Extension );
extensionParams = extSettings.ParameterValues;
if (extensionParams != null)
{
foreach (ParameterValueOrFieldReference extensionParam in extensionParams)
{
Console.WriteLine( ((ParameterValue)extensionParam).Name + ": " + ((ParameterValue)extensionParam).Value );
}
}
if ( values != null )
{
foreach ( ParameterValue pv in values )
{
Console.WriteLine( "Name: {0}", pv.Name );
Console.WriteLine( "Value: {0}", pv.Value );
}
}
}
}
catch ( SoapException e )
{
Console.WriteLine( e.Detail.InnerXml.ToString() );
}
}
}
備註
下表顯示此操作的標頭與權限資訊。
| SOAP 標頭 | (出局) ServerInfoHeaderValue |
| 必要權限 | (ReadSubscription 在報告上且用戶是訂閱擁有者)或 ReadAnySubscription |