ReportExecutionService.Render2 메서드

정의

네임스페이스:: ReportExecution2005

어셈블리:: ReportExecution2005.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

특정 보고서를 처리하여 지정된 형식으로 렌더링합니다.

public:
 cli::array <System::Byte> ^ Render2(System::String ^ Format, System::String ^ DeviceInfo, ReportExecution2005::PageCountMode PaginationMode, [Runtime::InteropServices::Out] System::String ^ % Extension, [Runtime::InteropServices::Out] System::String ^ % MimeType, [Runtime::InteropServices::Out] System::String ^ % Encoding, [Runtime::InteropServices::Out] cli::array <ReportExecution2005::Warning ^> ^ % Warnings, [Runtime::InteropServices::Out] cli::array <System::String ^> ^ % StreamIds);

public byte[] Render2(string Format, string DeviceInfo, ReportExecution2005.PageCountMode PaginationMode, out string Extension, out string MimeType, out string Encoding, out ReportExecution2005.Warning[] Warnings, out string[] StreamIds);

member this.Render2 : string * string * ReportExecution2005.PageCountMode * string * string * string * Warning[] * String[] -> byte[]

Public Function Render2 (Format As String, DeviceInfo As String, PaginationMode As PageCountMode, ByRef Extension As String, ByRef MimeType As String, ByRef Encoding As String, ByRef Warnings As Warning(), ByRef StreamIds As String()) As Byte()

매개 변수

Format: String

보고서를 작성하는 형식. 이 인수는 렌더링 확장에 대응합니다. 지원되는 확장 프로그램에는 XML, NULL, CSV, IMAGE, PDF, HTML4.0, HTML3.2, MHTML, EXCEL, Word가 포함됩니다. 지원되는 확장 목록은 메서드를 ListRenderingExtensions() 호출하여 얻을 수 있습니다.

DeviceInfo: String

매개변수에 Format 지정된 렌더링 확장 기능에 필요한 장치별 콘텐츠를 포함하는 XML 문자열입니다. DeviceInfo 설정은 DeviceInfo XML 요소의 내부 요소로 전달되어야 합니다. 특정 출력 형식의 장치 정보 설정에 대한 자세한 내용은 렌더링 확장에 대한 장치 정보 설정 전달을 참조하세요.

PaginationMode: PageCountMode

보고서가 처리되는 방식.

Extension: String

[아웃] 출력 스트림에 대응하는 파일 확장자입니다.

MimeType: String

[아웃] 렌더링된 보고서의 MIME 유형.

Encoding: String

[아웃] 보고서 서버가 보고서의 내용을 렌더링할 때 사용되는 인코딩입니다.

Warnings: Warning[]

[아웃] 보고서 처리 중에 발생한 경고를 설명하는 객체 배열 Warning 입니다.

StreamIds: String[]

[아웃] 스트림 식별자. 이 ID들은 메서드에 RenderStream(String, String, String, String, String) 전달됩니다. 이 도구를 사용해 특정 보고서와 연관된 외부 자원(이미지 등)을 렌더링할 수 있습니다.

반품

Byte[]

지정된 형식의 보고서 바이트[] 배열입니다.

설명

아래 표는 이 작업에 대한 헤더와 권한 정보를 보여줍니다.


SOAP 헤더 사용	(입) TrustedUserHeaderValue (입) ExecutionHeaderValue (아웃) ServerInfoHeaderValue
네이티브 모드 필요 권한	메인 보고서와 모든 하위 보고서에서: ReadProperties 그리고 ExecuteAndView
SharePoint 모드 필요 권한이 필요	주요 보고서와 모든 하위 보고서에 대해: <xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems>

Render2 헤더에서 ExecutionInfo2 식별된 보고서 실행과 연관된 처리된 보고서를 렌더링합니다. 세션 스냅샷이 없으면, 이 메서드는 모든 자격 증명 및 매개변수 요구사항이 충족되면 보고서를 실행하여 새로운 세션 스냅샷을 생성합니다. 비쿼리 매개변수 값이 변경되어 보고서를 재처리해야 할 경우, 스냅샷이 재처리됩니다.

실행 옵션이 캐시 또는 실행 스냅샷으로 설정되어 있다면, 호출 Render2 은 기존 스냅샷을 사용할 수 있습니다.

보고서가 캐시로 설정되어 있고 제공된 매개변수 값과 자격 증명이 일치하면, 캐시된 스냅샷 복사본이 실제로 보고서를 처리하는 대신 로드될 수 있습니다.

자격 증명 및 매개변수 요구사항이 충족되지 않으면 이 메서드는 오류를 반환합니다.

렌더링 확장 기능이 여러 페이지를 지정할 수 있다면, 이후의 호출 Render2 을 통해 추가 페이지 리포트를 가져올 수 있습니다.

렌더 방식의 한계는 출력이 스트리밍될 수 없으므로 전체 파일이 메모리 내에 있어야 한다는 점입니다.

실행 수명 주기에 대한 논의는 ' 실행 상태 식별(Identifying Execution State )'을 참조하라. 이 과정에는 보고서를 로드하고 렌더링하는 데 필요한 단계가 설명되어 있다.

적용 대상