Sprache

ReportingService2005.GetSubscriptionProperties Methode

Definition

Gibt die Eigenschaften eines bestimmten 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

[aus] Ein Objekt, das eine Liste von Einstellungen enthält, die spezifisch für die Liefererweiterung ExtensionSettings sind.

Description
String

[aus] Eine aussagekräftige Beschreibung, die den Nutzern angezeigt wird.

Active
ActiveState

[aus] Ein Objekt, das den aktiven Zustand des Abonnements ActiveState enthält.

Status
String

[aus] Der Status des Abonnements.

EventType
String

[aus] Die Art von Ereignis, die das Abonnement auslöst.

MatchData
String

[aus] Die Daten, die mit dem angegebenen Ereignistyp verbunden sind. Dies wird von einer Event-Processing-Erweiterung verwendet, um das Abonnement mit einem ausgelösten Event abzugleichen.

Parameters
ParameterValue[]

[aus] Ein Array von ParameterValue Objekten, das eine Liste von Parametern für den Bericht enthält.

Gibt zurück

Die Benutzer-ID des Inhabers des Abonnements.

Beispiele

Um dieses Codebeispiel zu kompilieren, müssen Sie auf die Reporting Services WSDL zurückgreifen und bestimmte Namensräume importieren. Weitere Informationen finden Sie unter Beispiele für Kompilierung und Ausführung von Coden. Das folgende Codebeispiel verwendet die Methode GetSubscriptionProperties , um die Eigenschaften eines der Abonnements für den Product Catalog-Bericht abzurufen, das dem Benutzer myDomain\myUserName gehört. Das Abonnement ist nicht datengesteuert, daher geht der Code davon aus, dass alle Einstellungen für die Liefererweiterung 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

Die untenstehende Tabelle zeigt Header- und Berechtigungsinformationen zu dieser Operation.

SOAP-Überschriften (Aus) ServerInfoHeaderValue
Erforderliche Berechtigungen (ReadSubscription auf dem Bericht UND der Nutzer ist der Inhaber des Abonnements) ODER ReadAnySubscription

Gilt für: