ReportingService2005.GetSubscriptionProperties Methode

Definition

Gibt die Eigenschaften eines angegebenen Abonnements zurück.

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

Parameter

SubscriptionID
String

Die ID des Abonnements.

ExtensionSettings
ExtensionSettings

[out] Ein ExtensionSettings-Objekt mit einer Liste von Einstellungen, die für die Übermittlungserweiterung spezifisch sind.

Description
String

[out] Eine aussagekräftige Beschreibung, die Benutzern angezeigt wird.

Active
ActiveState

[out] Ein ActiveState-Objekt, das den aktiven Status des Abonnements enthält.

Status
String

[out] Der Status des Abonnements.

EventType
String

[out] Der Typ des Ereignisses, das das Abonnement auslöst.

MatchData
String

[out] Die Daten, die dem angegebenen Ereignistyp zugeordnet sind. Wird von einer Erweiterung zur Ergeignisverarbeitung verwendet, um das Abonnement mit einem ausgelösten Ereignis zu vergleichen.

Parameters
ParameterValue[]

[out] Ein Array von ParameterValue-Objekten, das eine Liste der Parameter für den Bericht enthält.

Gibt zurück

Die Benutzer-ID des Abonnementbesitzers.

Beispiele

Um dieses Codebeispiel zu kompilieren, müssen Sie auf die Reporting Services WSDL verweisen und bestimmte Namespaces importieren. Weitere Informationen finden Sie unter Kompilieren und Ausführen von Codebeispielen. Im folgenden Codebeispiel wird die GetSubscriptionProperties -Methode verwendet, um die Eigenschaften eines der Abonnements für den Produktkatalogbericht abzurufen, der dem Benutzer myDomain\myUserName gehört. Das Abonnement ist nicht datengesteuert, sodass der Code davon ausgeht, dass alle Einstellungen für die Übermittlungserweiterung statische Parameterwerte (ParameterValue Objekte) sind:

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() );   
      }  
   }  
}  

Hinweise

In der folgenden Tabelle werden Header- und Berechtigungsinformationen zu diesem Vorgang dargestellt.

SOAP-Header (Out) ServerInfoHeaderValue
Erforderliche Berechtigungen (ReadSubscription im Bericht UND der Benutzer ist der Abonnementbesitzer) ODER ReadAnySubscription

Gilt für: