レポート サーバーに接続せずにローカルで処理されて表示されるレポートを表します。
継承階層
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 クラスの新しいインスタンスを初期化します。 |
Top
プロパティ
| 名前 | 説明 | |
|---|---|---|
.gif "パブリック プロパティ") |
DataSources | レポートで使用されるデータ ソースのコレクションを取得します。 |
|
DisplayName | レポートの表示名を取得または設定します。 (Report から継承されています。) |
|
EnableExternalImages | レポートに外部画像がある場合に表示可能かどうかを示します。 |
|
EnableHyperlinks | レポートにハイパーリンクのアクションがある場合に表示可能かどうかを示します。 |
|
IsDrillthroughReport | レポートがドリルスルー レポートかどうかを示します。 (Report から継承されています。) |
|
IsReadyForRendering | レポート定義とすべてのパラメーターが指定されており、すべてのデータ ソースが使用できる状態であるかどうかを示すブール値を取得します。 (Report から継承されています。) |
|
OriginalParametersToDrillthrough | レポートがドリルスルー レポートの場合、親レポートからそのレポートに渡されたパラメーターを返します。 |
|
ReportEmbeddedResource | レポートに埋め込まれたリソースの名前を取得または設定します。 |
|
ReportPath | ローカル レポートのローカル ファイル システムのパスを取得または設定します。 |
|
ShowDetailedSubreportMessages | サブレポートでエラーが発生したときに詳細なメッセージを表示するかどうかを示すブール値を取得または設定します。 |
Top
メソッド
.gif "プロテクト メソッド")
Top
イベント
| 名前 | 説明 | |
|---|---|---|
.gif "パブリック イベント") |
SubreportProcessing | サブレポートが処理されるときに発生します。 |
Top
明示的なインターフェイスの実装
| 名前 | 説明 | |
|---|---|---|
.gif "明示的なインターフェイスの実装") .gif "プライベート メソッド") |
ISerializable.GetObjectData |
Top
説明
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
スレッド セーフ
この型の public static (Visual Basic では Shared) のメンバーはすべて、スレッド セーフです。インスタンス メンバーの場合は、スレッド セーフであるとは限りません。