ReportingService2005.SetSubscriptionProperties Methode

Definition

Namespace:: ReportService2005

Assembly:: ReportService2005.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Legt die Eigenschaften eines Abonnements fest.

public:
 void SetSubscriptionProperties(System::String ^ SubscriptionID, ReportService2005::ExtensionSettings ^ ExtensionSettings, System::String ^ Description, System::String ^ EventType, System::String ^ MatchData, cli::array <ReportService2005::ParameterValue ^> ^ Parameters);

public void SetSubscriptionProperties(string SubscriptionID, ReportService2005.ExtensionSettings ExtensionSettings, string Description, string EventType, string MatchData, ReportService2005.ParameterValue[] Parameters);

member this.SetSubscriptionProperties : string * ReportService2005.ExtensionSettings * string * string * string * ReportService2005.ParameterValue[] -> unit

Public Sub SetSubscriptionProperties (SubscriptionID As String, ExtensionSettings As ExtensionSettings, Description As String, EventType As String, MatchData As String, Parameters As ParameterValue())

Parameter

SubscriptionID: String

Die ID des Abonnements.

ExtensionSettings: ExtensionSettings

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

Description: String

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

EventType: String

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

MatchData: String

Die Daten, die mit dem angegebenen Ereignistyp verbunden sind. Diese Daten werden von einer Event-Processing-Erweiterung verwendet, um das Abonnement mit einem ausgelösten Ereignis abzugleichen.

Parameters: ParameterValue[]

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

Hinweise

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


SOAP-Überschriften	(In) BatchHeaderValue (Aus) ServerInfoHeaderValue
Erforderliche Berechtigungen	UpdateAnySubscription ODER (UpdateSubscription UND der Nutzer ist der Berichtsinhaber und das Abonnement ist ein zeitlich begrenztes Abonnement)

Der Wert des Parameters EventType muss einer Ereignisverarbeitungserweiterung entsprechen, die auf dem Berichtsserver konfiguriert ist. Wenn der Ereignistyp nicht von einer Ereignisverarbeitungserweiterung behandelt wird, wird eine SOAP-Ausnahme mit dem Fehlercode rsInvalidEventgeworfen. Der Ereignistyp muss von einer Ereignisverarbeitungserweiterung behandelt werden, die Benachrichtigungen erstellt. Wenn ein Wert für den Parameter EventType empfangen wird, wird die Ereignisverarbeitungserweiterung abgerufen, um zu bestimmen, ob das Ereignis Benachrichtigungen erzeugt. Wenn nicht, wird eine SOAP-Ausnahme mit dem Fehlercode rsEventNonSubscribeablegeworfen.

Der Wert des Parameters MatchData hängt vom Ereignistyp ab. Wenn das Ereignis ein TimedSubscription-Ereignis ist, wird ein ScheduleDefinition Objekt als Parameter MatchData benötigt. Sie müssen das ScheduleDefinition Objekt zunächst als XML serialisieren, um es als String-Wert zu übergeben und ein Abonnement basierend auf dem Zeitplan zu erstellen. Die XML-Struktur könnte der im folgenden Beispiel ähneln:

<ScheduleDefinition>  
   <WeeklyRecurrence>  
      <StartDateTime>2003-02-24T09:00:00-08:00</StartDateTime>  
      <WeeksInterval>1</WeeksInterval>  
      <DaysOfWeek>  
         <Monday>True</Monday>  
         </DaysOfWeek>  
   </WeeklyRecurrence>  
</ScheduleDefinition>

Der Wert des StartDateTime-Elements , wenn es als XML-Zeichenkette übergeben wird, sollte dem Datumsformat ISO 8601 entsprechen. Dieser internationale Datums- und Uhrzeitstandard ist das erweiterte Format CCYY-MM-DDThh:mm:ss+/-Z, wobei "CC" das Jahrhundert, "YY" das Jahr, "MM" den Monat und "DD" den Tag darstellt. Der Buchstabe "T" ist Datums- und Zeittrenner, und "hh", "mm", "ss" stehen jeweils für Stunde, Minute und Sekunde. Diese Darstellung kann unmittelbar von einem "Z" gefolgt werden, um die koordinierte Universalzeit (UTC) anzuzeigen. Um die Zeitzone anzuzeigen, dargestellt als Differenz zwischen der Ortszeit und der koordinierten Universalzeit, wird "Z" von einem "+" oder "-" Zeichen vorangestellt, gefolgt von der Differenz von UTC, die als hh:mm dargestellt wird.

Wenn die Zeitplandefinition für ein TimedSubscription ein gemeinsamer Zeitplan ist, musst du die Zeitplan-ID des gemeinsamen Zeitplans als Parameter MatchData weitergeben. Die Schedule-ID wird beispielsweise als String"4608ac1b-fc75-4149-9e15-5a8b5781b843" weitergegeben. Die Zeitplan-ID kann durch Aufruf der Methode ListSchedules erhalten werden.

Wenn das Ereignis ein Snapshot-Update-Abonnement ist, setze MatchData den Parameter auf null (Nothing in Visual Basic).

Gilt für: