ReportExecutionService.Render2 메서드

정의

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

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

[out] 출력 스트림에 해당하는 파일 확장명입니다.

MimeType
String

[out] 렌더링된 보고서의 MIME 형식입니다.

Encoding
String

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

Warnings
Warning[]

[out] 보고서를 처리하는 동안 발생한 경고를 설명하는 Warning 개체의 배열입니다.

StreamIds
String[]

[out] 스트림 식별자입니다. 이러한 ID는 RenderStream(String, String, String, String, String) 메서드에 전달됩니다. 이러한 ID를 사용하여 지정된 보고서와 연결된 외부 리소스(예: 이미지)를 렌더링할 수 있습니다.

반환

Byte[]

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

설명

다음 표에서는 이 작업에 대한 헤더 및 사용 권한 정보를 보여 줍니다.

SOAP 헤더 사용 (In) TrustedUserHeaderValue

(In) ExecutionHeaderValue

(Out) ServerInfoHeaderValue
기본 모드 필수 권한 기본 보고서 및 모든 하위 보고서에서: ReadProperties ANDExecuteAndView
SharePoint 모드 필수 권한 기본 보고서 및 모든 하위 보고서에서 다음을 수행합니다.<xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems>

Render2 는 헤더에서 식별된 보고서 실행과 연결된 처리된 ExecutionInfo2 보고서를 렌더링합니다. 세션 스냅샷 없는 경우 이 메서드는 보고서를 실행합니다(모든 자격 증명 및 매개 변수 요구 사항이 충족되는 경우). 그러면 새 세션 스냅샷 만들어집니다. 쿼리가 아닌 매개 변수 값이 변경되어 보고서를 다시 처리해야 하는 경우 스냅샷 다시 처리됩니다.

실행 옵션이 캐시 또는 실행 스냅샷 설정된 경우 에 대한 호출 Render2 은 기존 스냅샷 사용할 수 있습니다.

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

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

렌더링 확장 프로그램에서 여러 페이지 지정을 지원하는 경우 에 대한 후속 호출 Render2 을 사용하여 보고서의 추가 페이지를 가져올 수 있습니다.

Render 메서드의 제한 사항은 출력을 스트리밍할 수 없으므로 전체 파일이 메모리에 있어야 한다는 것입니다.

보고서를 로드하고 렌더링하는 데 필요한 단계에 대한 설명이 포함된 실행 수명 주기에 대한 설명은 실행 상태 식별 을 참조하세요.

적용 대상