Metoda ReportingService2006.SetDataDrivenSubscriptionProperties

Składnia

'Deklaracja
<SoapHeaderAttribute("ServerInfoHeaderValue", Direction := SoapHeaderDirection.Out)> _
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices/SetDataDrivenSubscriptionProperties", RequestNamespace := "https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices",  _
    ResponseNamespace := "https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices",  _
    Use := SoapBindingUse.Literal, ParameterStyle := SoapParameterStyle.Wrapped)> _
<SoapHeaderAttribute("TrustedUserHeaderValue")> _
Public Sub SetDataDrivenSubscriptionProperties ( _
    DataDrivenSubscriptionID As String, _
    ExtensionSettings As ExtensionSettings, _
    DataRetrievalPlan As DataRetrievalPlan, _
    Description As String, _
    EventType As String, _
    MatchData As String, _
    Parameters As ParameterValueOrFieldReference() _
)
'Użycie
Dim instance As ReportingService2006
Dim DataDrivenSubscriptionID As String
Dim ExtensionSettings As ExtensionSettings
Dim DataRetrievalPlan As DataRetrievalPlan
Dim Description As String
Dim EventType As String
Dim MatchData As String
Dim Parameters As ParameterValueOrFieldReference()

instance.SetDataDrivenSubscriptionProperties(DataDrivenSubscriptionID, _
    ExtensionSettings, DataRetrievalPlan, _
    Description, EventType, MatchData, _
    Parameters)

[SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)]
[SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices/SetDataDrivenSubscriptionProperties", RequestNamespace = "https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices", 
    ResponseNamespace = "https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices", 
    Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)]
[SoapHeaderAttribute("TrustedUserHeaderValue")]
public void SetDataDrivenSubscriptionProperties(
    string DataDrivenSubscriptionID,
    ExtensionSettings ExtensionSettings,
    DataRetrievalPlan DataRetrievalPlan,
    string Description,
    string EventType,
    string MatchData,
    ParameterValueOrFieldReference[] Parameters
)

[SoapHeaderAttribute(L"ServerInfoHeaderValue", Direction = SoapHeaderDirection::Out)]
[SoapDocumentMethodAttribute(L"https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices/SetDataDrivenSubscriptionProperties", RequestNamespace = L"https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices", 
    ResponseNamespace = L"https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices", 
    Use = SoapBindingUse::Literal, ParameterStyle = SoapParameterStyle::Wrapped)]
[SoapHeaderAttribute(L"TrustedUserHeaderValue")]
public:
void SetDataDrivenSubscriptionProperties(
    String^ DataDrivenSubscriptionID, 
    ExtensionSettings^ ExtensionSettings, 
    DataRetrievalPlan^ DataRetrievalPlan, 
    String^ Description, 
    String^ EventType, 
    String^ MatchData, 
    array<ParameterValueOrFieldReference^>^ Parameters
)

[<SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)>]
[<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices/SetDataDrivenSubscriptionProperties", RequestNamespace = "https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices", 
    ResponseNamespace = "https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices", 
    Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)>]
[<SoapHeaderAttribute("TrustedUserHeaderValue")>]
member SetDataDrivenSubscriptionProperties : 
        DataDrivenSubscriptionID:string * 
        ExtensionSettings:ExtensionSettings * 
        DataRetrievalPlan:DataRetrievalPlan * 
        Description:string * 
        EventType:string * 
        MatchData:string * 
        Parameters:ParameterValueOrFieldReference[] -> unit 

public function SetDataDrivenSubscriptionProperties(
    DataDrivenSubscriptionID : String, 
    ExtensionSettings : ExtensionSettings, 
    DataRetrievalPlan : DataRetrievalPlan, 
    Description : String, 
    EventType : String, 
    MatchData : String, 
    Parameters : ParameterValueOrFieldReference[]
)

Uwagi

W poniższej tabela przedstawiono informacje nagłówka i uprawnienia na tej operacji.

Aby sterowanych danymi subskrypcja działać poprawnie, źródło danych, DataRetrievalPlan musi mieć odwołania do obiektu CredentialRetrieval Właściwość zestaw do Magazyn.

Field Obiektów zawartych w DataSet są porównywane z pól, które są mapowane na rozszerzenie dostarczania ustawienia i wartości parametru raportu.Wszystkie pola, które w rozszerzenie dostarczania ustawienia i wartości parametrów raportu również musi wyliczyć w zestawie danych.

Nie sprawdzanie poprawności jest wykonywane dla zapewnienia, że pola wyliczane w zestawie danych są zwracane przez kwerendy dostawy.Jeśli pole, które jest wyliczana w zestawie danych nie zostanie zwrócony przez kwerendę dostawy, serwer raportów zgłasza błąd podczas przetwarzania subskrypcja.

Wartość EventType parametru musi odpowiadać zdarzenie przetwarzania rozszerzenia, która jest skonfigurowana serwer raportów.Jeśli zdarzenie nie jest obsługiwany przez rozszerzenie przetwarzania zdarzeń, protokół SOAP jest wyjątek z kodem błędu rsInvalidEvent.Zdarzenia musi być obsługiwane przez zdarzenie przetwarzania rozszerzenia, która tworzy powiadomienia.Gdy wartość dla EventType parametr jest odbierana, zdarzenie przetwarzania rozszerzenie jest proszeni o określenie, czy tworzy powiadomienia.Jeśli nie, protokół SOAP jest wyjątek z kodem błędu rsEventNonSubscribeable.

Wartość MatchData zależy od parametru typu zdarzenie.Jeśli zdarzenie jest TimedSubscription zdarzenie, ScheduleDefinition obiektu wymagany jest jako MatchData parametru.Musisz najpierw serializować ScheduleDefinition jako XML w celu przekazania go jako wartość ciąg i utworzyć obiekt subskrypcja zależności harmonogramu.Struktura XML może wyglądać tak jak w następującym przykładzie:

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

Wartość początekDataCzas elementu, gdy dane są przekazywane jako ciąg znaków XML powinien odpowiadać format data ISO 8601.Międzynarodowe data i czas standardowy jest rozszerzony format SSRR-MM-DDThh:mm:ss +/-Z którym "DW" reprezentuje stulecia "Rr" rok "MM" miesiąc i "dd" dzień.Litera "T" Data i czas separator i "gg", "mm", "ss" reprezentują godziny, minuty i sekundy odpowiednio.Reprezentacja ta może być natychmiast następuje "Z" Aby wskazać skoordynowanego czasu uniwersalnego (UTC).Aby wskazać strefę czasową, reprezentowany jako różnicę między czas lokalnym a Coordinated Universal czas "Z" jest poprzedzony przez "+" lub "-" znak, różnica z UTC reprezentowane jako hh: mm.

Jeśli definicja harmonogram TimedSubscription jest udostępniony harmonogram, a następnie należy przepuścić identyfikator harmonogramu harmonogram udostępnionego jako MatchData parametru.Harmonogram jest przekazywany identyfikator, jako ciąg, na przykład "4608ac1b-fc75-4149-9e15-5a8b5781b843".Harmonogram można uzyskać Identyfikatora, wywołując ListSchedules() metoda.

Można użyć XmlSerializer klasy, aby automatycznie przekonwertować ciąg XML klasy obiektu.Więcej informacji o XmlSerializer klasy, zobacz "Klasa System.Xml.XmlSerializer" w programie Microsoft.NET Framework dokumentacji.

Jeśli zdarzenie jest migawka subskrypcja aktualizacji, wartość MatchData powinny być parametr nullodwołanie o wartości null (Nothing w języku Visual Basic) (nic nie w języku Visual Basic).

Zobacz także

Odwołanie