Freigeben über


CreateReportHistorySnapshot-Methode

Erzeugt die Berichtsverlaufs-Momentaufnahme eines angegebenen Berichts.

Namespace:  ReportService2006
Assembly:  ReportService2006 (in ReportService2006.dll)

Syntax

'Declaration
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices/CreateReportHistorySnapshot", 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("ServerInfoHeaderValue", Direction := SoapHeaderDirection.Out)> _
<SoapHeaderAttribute("TrustedUserHeaderValue")> _
Public Function CreateReportHistorySnapshot ( _
    Report As String, _
    <OutAttribute> ByRef Warnings As Warning() _
) As String
'Usage
Dim instance As ReportingService2006
Dim Report As String
Dim Warnings As Warning()
Dim returnValue As String

returnValue = instance.CreateReportHistorySnapshot(Report, _
    Warnings)
[SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices/CreateReportHistorySnapshot", 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("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)]
[SoapHeaderAttribute("TrustedUserHeaderValue")]
public string CreateReportHistorySnapshot(
    string Report,
    out Warning[] Warnings
)
[SoapDocumentMethodAttribute(L"https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices/CreateReportHistorySnapshot", 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"ServerInfoHeaderValue", Direction = SoapHeaderDirection::Out)]
[SoapHeaderAttribute(L"TrustedUserHeaderValue")]
public:
String^ CreateReportHistorySnapshot(
    String^ Report, 
    [OutAttribute] array<Warning^>^% Warnings
)
[<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices/CreateReportHistorySnapshot", 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("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)>]
[<SoapHeaderAttribute("TrustedUserHeaderValue")>]
member CreateReportHistorySnapshot : 
        Report:string * 
        Warnings:Warning[] byref -> string 
public function CreateReportHistorySnapshot(
    Report : String, 
    Warnings : Warning[]
) : String

Parameter

  • Report
    Typ: System. . :: . .String
    Die vollqualifizierte URL des Berichts einschließlich des Dateinamens und der Dateinamenerweiterung (.rdl).

Rückgabewert

Typ: System. . :: . .String
Ein String-Wert, der das Datum und den Zeitstempel der Momentaufnahme darstellt. Diese Zeichenfolge wird als eindeutiger Bezeichner für die historische Momentaufnahme verwendet.

Hinweise

The table below shows header and permissions information on this operation.

SOAP Headers

(In) TrustedUserHeaderValue

(Out) ServerInfoHeaderValue

Required Permissions

EditListItems()()()() AND ViewListItems()()()()

For the snapshot to be generated successfully, report history must be enabled for the report. To enable report history for a report, use the SetReportHistoryOptions method.

If the report contains subreports, query result sets from the subreports are persisted in the report history snapshot. Report parameters that are passed to the report at the time the report is executed are also persisted.

Snapshots are created by the CreateReportHistorySnapshot method with default report parameters only.

The length of the Report parameter cannot exceed 260 characters; otherwise, a SOAP exception is thrown with the error code rsItemLengthExceeded.

The Report parameter cannot be null or empty or contain the following reserved characters: : ? ; @ & = + $ , \ * > < | . ". You can use the forward slash character (/) to separate items in the full path name of the folder, but you cannot use it at the end of the folder name.