Udostępnij za pośrednictwem

  • Artykuł

Metoda ReportExecutionService.Render2

Przetwarza określonego raportu i czyni to w określonym formacie.

Przestrzeń nazw:  ReportExecution2005
Zestaw:  ReportExecution2005 (w ReportExecution2005.dll)

Składnia

'Deklaracja
<SoapHeaderAttribute("ServerInfoHeaderValue", Direction := SoapHeaderDirection.Out)> _
<SoapHeaderAttribute("ExecutionHeaderValue")> _
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices/Render2", RequestNamespace := "https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices",  _
    ResponseNamespace := "https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices",  _
    Use := SoapBindingUse.Literal, ParameterStyle := SoapParameterStyle.Wrapped)> _
<SoapHeaderAttribute("TrustedUserHeaderValue")> _
Public Function Render2 ( _
    Format As String, _
    DeviceInfo As String, _
    PaginationMode As PageCountMode, _
    <OutAttribute> ByRef Extension As String, _
    <OutAttribute> ByRef MimeType As String, _
    <OutAttribute> ByRef Encoding As String, _
    <OutAttribute> ByRef Warnings As Warning(), _
    <OutAttribute> ByRef StreamIds As String() _
) As Byte()
'Użycie
Dim instance As ReportExecutionService
Dim Format As String
Dim DeviceInfo As String
Dim PaginationMode As PageCountMode
Dim Extension As String
Dim MimeType As String
Dim Encoding As String
Dim Warnings As Warning()
Dim StreamIds As String()
Dim returnValue As Byte()

returnValue = instance.Render2(Format, _
    DeviceInfo, PaginationMode, Extension, _
    MimeType, Encoding, Warnings, StreamIds)

[SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)]
[SoapHeaderAttribute("ExecutionHeaderValue")]
[SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices/Render2", RequestNamespace = "https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", 
    ResponseNamespace = "https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", 
    Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)]
[SoapHeaderAttribute("TrustedUserHeaderValue")]
public byte[] Render2(
    string Format,
    string DeviceInfo,
    PageCountMode PaginationMode,
    out string Extension,
    out string MimeType,
    out string Encoding,
    out Warning[] Warnings,
    out string[] StreamIds
)

[SoapHeaderAttribute(L"ServerInfoHeaderValue", Direction = SoapHeaderDirection::Out)]
[SoapHeaderAttribute(L"ExecutionHeaderValue")]
[SoapDocumentMethodAttribute(L"https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices/Render2", RequestNamespace = L"https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", 
    ResponseNamespace = L"https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", 
    Use = SoapBindingUse::Literal, ParameterStyle = SoapParameterStyle::Wrapped)]
[SoapHeaderAttribute(L"TrustedUserHeaderValue")]
public:
array<unsigned char>^ Render2(
    String^ Format, 
    String^ DeviceInfo, 
    PageCountMode PaginationMode, 
    [OutAttribute] String^% Extension, 
    [OutAttribute] String^% MimeType, 
    [OutAttribute] String^% Encoding, 
    [OutAttribute] array<Warning^>^% Warnings, 
    [OutAttribute] array<String^>^% StreamIds
)

[<SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)>]
[<SoapHeaderAttribute("ExecutionHeaderValue")>]
[<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices/Render2", RequestNamespace = "https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", 
    ResponseNamespace = "https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", 
    Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)>]
[<SoapHeaderAttribute("TrustedUserHeaderValue")>]
member Render2 : 
        Format:string * 
        DeviceInfo:string * 
        PaginationMode:PageCountMode * 
        Extension:string byref * 
        MimeType:string byref * 
        Encoding:string byref * 
        Warnings:Warning[] byref * 
        StreamIds:string[] byref -> byte[] 

public function Render2(
    Format : String, 
    DeviceInfo : String, 
    PaginationMode : PageCountMode, 
    Extension : String, 
    MimeType : String, 
    Encoding : String, 
    Warnings : Warning[], 
    StreamIds : String[]
) : byte[]

Parametry

  • Format
    Typ: System.String
    Format raportu renderowania.Argument ten jest mapowany na rozszerzenie renderowania.Obsługiwane rozszerzenia obejmują XML, NULL, CSV, obraz, PDF, HTML4.0, HTML3.2, MHTML, EXCEL i Word.Listy obsługiwanych rozszerzeń można otrzymać poprzez wywołanie ListRenderingExtensions metoda.
  • DeviceInfo
    Typ: System.String
    Ciąg XML zawierający zawartość specyficzne dla urządzenia wymagane przez rozszerzenie renderowania, określone w Format parametru.Ustawienia DeviceInfo musi być przekazany jako wewnętrznych elementów element DeviceInfo XML.Aby uzyskać więcej informacji na temat urządzenia ustawienia informacji dla formatów wyjściowych określonych Zobacz ustawienia informacji urządzenia fe718939-7efe-4c7f-87cb-5f5b09caeff4.
  • Extension
    Typ: System.String%
    [Brak] Rozszerzenie pliku odpowiadające strumień wyjściowy.
  • MimeType
    Typ: System.String%
    [Brak] Typ MIME renderowany raport.
  • Encoding
    Typ: System.String%
    [Brak] Kodowanie używane, gdy serwer raportów renderowania zawartości raportu.
  • Warnings
    Typ: array<ReportExecution2005.Warning[]%
    [Brak] Tablica Warning obiektów, które opisano wszystkie ostrzeżenia, które wystąpiły podczas przetwarzania raportu.
  • StreamIds
    Typ: array<System.String[]%
    [Brak] Identyfikatory strumienia.Identyfikatory te są przekazywane do RenderStream metoda.Można ich używać do renderowania zasobów zewnętrznych (obrazy, itp.), które są skojarzone z danego raportu.

Wartość zwracana

Typ: array<System.Byte[]
A Byte [ tablicy raport w określonym formacie.

Uwagi

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

Użycie nagłówek protokołu SOAP

(W)TrustedUserHeaderValue

(W)ExecutionHeaderValue

(Ruch wychodzący)ServerInfoHeaderValue

Tryb macierzysty wymagane uprawnienia

Raport główny i wszystkie podraporty: ReadProperties ORAZ ExecuteAndView

Tryb programu SharePoint wymagane uprawnienia

Raport główny i wszystkie podraporty: ViewListItems()

Render2renderuje przetworzonych raporcie skojarzonym z wykonanie sprawozdanie, określone w ExecutionInfo2 nagłówka.Jeśli migawka sesja nie istnieje, Metoda ta będzie wykonać raportu (jeśli są spełnione wszystkie wymagania poświadczeń i parametrów), wynikające z tworzenia migawki nowej sesja.Jeśli raport musi być ponownie przetwarzany, ponieważ wartości parametrów kwerendy nie zostały zmienione, migawka zostanie ponownie przetwarzane.

Jeśli opcje wykonanie są zestaw do pamięci podręcznej lub wykonanie migawka, wywołanie Render2 mogą używać istniejących migawka.

Jeśli raport jest zestaw do pamięci podręcznej i podanej wartości parametru, a poświadczenia zgodności, buforowaną kopię migawka mogą być ładowane zamiast faktycznie przetwarzania raportu.

Jeśli nie są spełnione wymagania poświadczeń i parametr, ta metoda zwróci błąd.

Kolejne wywołania Render2 można pobrać dodatkowe strony raportu, jeśli rozszerzenie renderowania obsługuje Określanie wielu stron.

Ograniczenia metoda renderowania jest, że dane wyjściowe nie strumieniowo, więc całego pliku w pamięci.

Zobacz Identyfikowanie stan wykonywania dla dyskusji wykonanie cyklu życia, które zawiera opis kroków niezbędnych do ładowania i renderowania raportu.