ReportingService2010.SetDataDrivenSubscriptionProperties Methode

public:
 void SetDataDrivenSubscriptionProperties(System::String ^ DataDrivenSubscriptionID, ReportService2010::ExtensionSettings ^ ExtensionSettings, ReportService2010::DataRetrievalPlan ^ DataRetrievalPlan, System::String ^ Description, System::String ^ EventType, System::String ^ MatchData, cli::array <ReportService2010::ParameterValueOrFieldReference ^> ^ Parameters);

[System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/SetDataDrivenSubscriptionProperties", 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("TrustedUserHeaderValue")]
[System.Web.Services.Protocols.SoapHeader("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)]
public void SetDataDrivenSubscriptionProperties (string DataDrivenSubscriptionID, ReportService2010.ExtensionSettings ExtensionSettings, ReportService2010.DataRetrievalPlan DataRetrievalPlan, string Description, string EventType, string MatchData, ReportService2010.ParameterValueOrFieldReference[] Parameters);

[<System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/SetDataDrivenSubscriptionProperties", 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("TrustedUserHeaderValue")>]
[<System.Web.Services.Protocols.SoapHeader("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)>]
member this.SetDataDrivenSubscriptionProperties : string * ReportService2010.ExtensionSettings * ReportService2010.DataRetrievalPlan * string * string * string * ReportService2010.ParameterValueOrFieldReference[] -> unit

Public Sub SetDataDrivenSubscriptionProperties (DataDrivenSubscriptionID As String, ExtensionSettings As ExtensionSettings, DataRetrievalPlan As DataRetrievalPlan, Description As String, EventType As String, MatchData As String, Parameters As ParameterValueOrFieldReference())

Parameter

Attribute

SoapDocumentMethodAttribute SoapHeaderAttribute

Hinweise

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

Damit das datengesteuerte Abonnement ordnungsgemäß ausgeführt werden kann, muss die Datenquelle, auf die das DataRetrievalPlan Objekt verweist, über eine CredentialRetrieval -Eigenschaft verfügen, die auf festgelegt ist Store.

Die Field in DataSet enthaltenen -Objekte werden anhand der Felder überprüft, die den Einstellungen der Übermittlungserweiterung und berichtsparameterwerten zugeordnet sind. Alle Felder, auf die in Übermittlungserweiterungseinstellungen und Berichtsparameterwerten verwiesen wird, müssen ebenfalls im Dataset aufgezählt werden.

Es wird keine Überprüfung durchgeführt, um sicherzustellen, dass im Dataset aufgezählte Felder von der Übermittlungsabfrage zurückgegeben werden. Wenn ein Feld, das im Dataset aufgelistet ist, von der Übermittlungsabfrage nicht zurückgegeben wird, löst der Berichtsserver bei der Verarbeitung des Abonnements einen Fehler aus.

Der Wert des EventType Parameters muss einer Ereignisverarbeitungserweiterung entsprechen, die auf dem Berichtsserver konfiguriert ist. Wenn ein Ereignis nicht von einer Ereignisverarbeitungserweiterung behandelt wird, wird eine SOAP-Ausnahme mit dem Fehlercode rsInvalidEventausgelöst. Das Ereignis muss von einer Ereignisverarbeitungserweiterung behandelt werden, die Benachrichtigungen erstellt. Wenn ein Wert für den EventType Parameter empfangen wird, wird die Ereignisverarbeitungserweiterung abgefragt, um zu bestimmen, ob Benachrichtigungen erstellt werden. Wenn dies nicht der Fall ist, wird eine SOAP-Ausnahme mit dem Fehlercode rsEventNonSubscribeableausgelöst.

Der Wert des MatchData Parameters hängt vom Ereignistyp ab. Wenn es sich bei dem Ereignis um ein TimedSubscription-Ereignis handelt, ist ein ScheduleDefinition -Objekt als MatchData Parameter erforderlich. Sie müssen das ScheduleDefinition Objekt zunächst als XML serialisieren, um es als Zeichenfolgenwert zu übergeben und ein Abonnement basierend auf dem Zeitplan zu erstellen. Die XML-Struktur kann wie im folgenden Beispiel aussehen:

<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-Zeichenfolge ü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, "JJ" das Jahr, "MM" den Monat und "TT" den Tag darstellt. Der Buchstabe "T" ist das Datums- und Uhrzeittrennzeichen und "hh", "mm", "ss" steht für Stunde, Minute und Sekunde. Dieser Darstellung kann unmittelbar ein "Z" folgen, um die koordinierte Weltzeit (UTC) anzugeben. Um die Zeitzone anzugeben, die als Unterschied zwischen der Ortszeit und der koordinierten Weltzeit dargestellt wird, wird "Z" ein "+"- oder "-"-Zeichen vorangestellt, gefolgt von der Differenz von UTC, die als hh:mm dargestellt wird.

Wenn die Zeitplandefinition für eine TimedSubscription ein freigegebener Zeitplan ist, müssen Sie die Zeitplan-ID des freigegebenen Zeitplans MatchData als Parameter übergeben. Die Zeitplan-ID wird als übergeben, z. B String. "4608ac1b-fc75-4149-9e15-5a8b5781b843". Die Zeitplan-ID kann durch Aufrufen der ListSchedules -Methode abgerufen werden.

Sie können die XmlSerializer-Klasse verwenden, um Ihre Objektklasse automatisch in eine XML-Zeichenfolge zu konvertieren. Weitere Informationen zur XmlSerializer-Klasse finden Sie unter "System.Xml. XmlSerializer-Klasse" in der Microsoft .NET Framework-Dokumentation.

Wenn es sich bei dem Ereignis um ein Momentaufnahme Updateabonnement handelt, sollte der MatchData Wert des Parameters (Nothing in Visual Basic) sein null .

Gilt für: