LocalReport 클래스
보고서 서버에 연결하지 않고 로컬에서 처리 및 렌더링되는 보고서를 나타냅니다.
상속 계층
System.Object
Microsoft.Reporting.WebForms.Report
Microsoft.Reporting.WebForms.LocalReport
네임스페이스: Microsoft.Reporting.WebForms
어셈블리: Microsoft.ReportViewer.WebForms(Microsoft.ReportViewer.WebForms.dll)
구문
‘선언
<SerializableAttribute> _
Public NotInheritable Class LocalReport _
Inherits Report _
Implements ISerializable, IDisposable
‘사용 방법
Dim instance As LocalReport
[SerializableAttribute]
public sealed class LocalReport : Report,
ISerializable, IDisposable
[SerializableAttribute]
public ref class LocalReport sealed : public Report,
ISerializable, IDisposable
[<SealedAttribute>]
[<SerializableAttribute>]
type LocalReport =
class
inherit Report
interface ISerializable
interface IDisposable
end
public final class LocalReport extends Report implements ISerializable, IDisposable
LocalReport 유형에서 다음 멤버를 표시합니다.
생성자
| 이름 | 설명 | |
|---|---|---|
.gif "공용 메서드") |
LocalReport | LocalReport 클래스의 새 인스턴스를 초기화합니다. |
맨 위로 이동
속성
| 이름 | 설명 | |
|---|---|---|
.gif "공용 속성") |
DataSources | 보고서에 사용된 데이터 소스 컬렉션을 가져옵니다. |
|
DisplayName | 보고서의 표시 이름을 가져오거나 설정합니다. (Report에서 상속됨) |
|
EnableExternalImages | 외부 이미지를 포함하는 보고서를 렌더링할 수 있는지 여부를 나타냅니다. |
|
EnableHyperlinks | 하이퍼링크 동작을 포함하는 보고서를 렌더링할 수 있는지 여부를 나타냅니다. |
|
IsDrillthroughReport | 보고서가 드릴스루 보고서인지 여부를 나타냅니다. (Report에서 상속됨) |
|
IsReadyForRendering | 보고서 정의와 모든 매개 변수가 지정되었고 모든 데이터 소스를 사용할 준비가 되었는지 여부를 나타내는 Boolean 값을 가져옵니다. (Report에서 상속됨) |
|
OriginalParametersToDrillthrough | 이 보고서가 드릴스루 보고서인 경우 부모 보고서에서 이 보고서로 전달된 매개 변수를 반환합니다. |
|
ReportEmbeddedResource | 보고서 포함 리소스의 이름을 가져오거나 설정합니다. |
|
ReportPath | 로컬 보고서의 로컬 파일 시스템 경로를 가져오거나 설정합니다. |
|
ShowDetailedSubreportMessages | 포함된 보고서에 오류가 발생할 때 자세한 메시지를 표시해야 하는지 여부를 나타내는 Boolean 값을 가져오거나 설정합니다. |
맨 위로 이동
메서드
.gif "보호된 메서드")
맨 위로 이동
이벤트
| 이름 | 설명 | |
|---|---|---|
.gif "공용 이벤트") |
SubreportProcessing | 포함된 보고서가 처리될 때 발생합니다. |
맨 위로 이동
명시적 인터페이스 구현
| 이름 | 설명 | |
|---|---|---|
.gif "명시적 인터페이스 구현") .gif "전용 메서드") |
ISerializable.GetObjectData |
맨 위로 이동
주의
LocalReport 클래스는 보고서 서버에 연결하지 않고 로컬에서 처리 및 렌더링되는 보고서를 나타냅니다. 이 클래스는 ReportViewer 컨트롤에 사용되는 개체와 동일하지만 ReportViewer 컨트롤의 핵심 기능을 캡슐화하는 비가시 개체로 독립적으로 사용될 수도 있습니다.
LocalReport 개체는 파일 시스템이나 포함 리소스에서 클라이언트 보고서 정의 파일(RDLC)을 열 수 있습니다. RDLC 파일을 Stream 또는 TextReader로 제공할 수도 있습니다.
LocalReport 개체는 쿼리를 실행하거나 데이터를 인출할 수 없으므로 데이터 소스가 DataSources 컬렉션 속성에 추가되어야 합니다.
LocalReport 개체는 보고서 매개 변수를 지원하지만 매개 변수 프롬프트는 지원하지 않습니다.
예
다음 코드 예에서는 LocalReport 개체를 사용하여 보고서를 로드하고 내보냅니다.
protected void Button1_Click(object sender, EventArgs e)
{
Microsoft.Reporting.WebForms.LocalReport lr =
new Microsoft.Reporting.WebForms.LocalReport();
string deviceInfo =
"<DeviceInfo>" +
"<SimplePageHeaders>True</SimplePageHeaders>" +
"</DeviceInfo>";
lr.ReportPath = @"C:\My Reports\Monthly Sales.rdlc";
lr.DataSources.Add(new ReportDataSource("Sales", GetSalesData()));
byte[] bytes = lr.Render("Excel", deviceInfo, out mimeType,
out encoding, out streamids, out warnings);
using (FileStream fs = new FileStream(@"c:\My Reports\Monthly Sales.xls", FileMode.Create))
{
fs.Write(bytes, 0, bytes.Length);
}
}
Protected Sub Button1_Click(ByVal sender As Object, _
ByVal e As System.EventArgs) Handles Button1.Click
Dim warnings As Warning() = Nothing
Dim streamids As String() = Nothing
Dim mimeType As String = Nothing
Dim encoding As String = Nothing
Dim extension As String = Nothing
Dim deviceInfo as string
Dim bytes As Byte()
Dim lr As New Microsoft.Reporting.WebForms.LocalReport
lr.ReportPath = "C:\My Reports\Monthly Sales.rdlc"
lr.DataSources.Add(New ReportDataSource("Sales", GetSalesData()))
deviceInfo = _
"<DeviceInfo><SimplePageHeaders>True</SimplePageHeaders></DeviceInfo>"
bytes = ReportViewer1.LocalReport.Render("Excel", deviceInfo,_
mimeType, encoding, extension, streamids, warnings)
Dim fs As New FileStream("c:\output.xls", FileMode.Create)
fs.Write(bytes, 0, bytes.Length)
End Sub
스레드 보안
이 유형의 모든 공용 static(Visual Basic에서는 Shared) 멤버는 스레드로부터 안전합니다. 인스턴스 멤버는 스레드로부터의 안전성이 보장되지 않습니다.