ReportingService2005.CreateReport メソッド
新しいレポートをレポート サーバー データベースに追加します。
名前空間: ReportService2005
アセンブリ: ReportService2005 (ReportService2005.dll)
構文
'宣言
Public Function CreateReport ( _
Report As String, _
Parent As String, _
Overwrite As Boolean, _
Definition As Byte(), _
Properties As Property() _
) As Warning()
'使用
Dim instance As ReportingService2005
Dim Report As String
Dim Parent As String
Dim Overwrite As Boolean
Dim Definition As Byte()
Dim Properties As Property()
Dim returnValue As Warning()
returnValue = instance.CreateReport(Report, _
Parent, Overwrite, Definition, Properties)
public Warning[] CreateReport(
string Report,
string Parent,
bool Overwrite,
byte[] Definition,
Property[] Properties
)
public:
array<Warning^>^ CreateReport(
String^ Report,
String^ Parent,
bool Overwrite,
array<unsigned char>^ Definition,
array<Property^>^ Properties
)
member CreateReport :
Report:string *
Parent:string *
Overwrite:bool *
Definition:byte[] *
Properties:Property[] -> Warning[]
public function CreateReport(
Report : String,
Parent : String,
Overwrite : boolean,
Definition : byte[],
Properties : Property[]
) : Warning[]
パラメーター
- Report
型: System.String
新しいレポートの名前です。
- Parent
型: System.String
レポートを追加する親フォルダーの完全修飾 URL です。
- Overwrite
型: System.Boolean
指定された場所に同じ名前のレポートが既に存在する場合に上書きするかどうかを示す Boolean 式です。
- Definition
型: array<System.Byte[]
レポート サーバーにパブリッシュするレポート定義です。これは .rdl ファイルの内容です。 XML データは、レポート定義言語 (https://schemas.microsoft.com/sqlserver/reporting/2008/01/reportdefinition/) によって定義されています。
- Properties
型: array<ReportService2005.Property[]
レポートに設定するプロパティの名前と値が格納される Property オブジェクトの配列です。
戻り値
型: array<ReportService2005.Warning[]
レポート定義の検証時に発生したすべての警告を表す Warning オブジェクトの配列です。
説明
次の表に、この操作に関連するヘッダーおよび権限の情報を示します。
SOAP ヘッダー |
(In) BatchHeaderValue (Out) ServerInfoHeaderValue |
必要な権限 |
新しいレポートの作成: Parent に対する CreateReport、レポートのデータ ソースに対する ReadProperties、およびレポートのデータセットに対する ReadProperties 既存のレポートの更新: Report に対する UpdateReportDefinition、Report に対する UpdateProperties (Properties にプロパティが含まれている場合)、レポートのデータ ソースに対する UpdateProperties、およびレポートのデータセットに対する UpdateProperties |
Parent パラメーターの長さは、260 文字以下でなければなりません。これを超えると、エラー コード rsItemLengthExceeded の SOAP 例外がスローされます。
Parent パラメーターを NULL または空の文字列にすることはできません。また、予約文字 : ?; @ & = + $ , \ * > < | ." を含めることもできません。 スラッシュ (/) は、フォルダーの完全なパス名内の各項目を区切るために使用することはできますが、フォルダー名の末尾には使用できません。
エラーが発生すると、レポートは作成されません。
レポート サーバー データベースにレポートを追加すると、親フォルダーの ModifiedBy プロパティと ModifiedDate プロパティが変更されます。
使用例
このコード例をコンパイルするには、Reporting Services の WSDL を参照し、特定の名前空間をインポートする必要があります。 詳細については、「Compiling and Running Code Examples」を参照してください。 次のコード例では、レポート定義言語 (RDL) ファイル形式でレポート サーバー データベースにレポートをパブリッシュします。
Imports System
Imports System.IO
Imports System.Web.Services.Protocols
Class Sample
Public Shared Sub Main()
Dim rs As New ReportingService2005()
rs.Credentials = System.Net.CredentialCache.DefaultCredentials
Dim definition As [Byte]() = Nothing
Dim warnings As Warning() = Nothing
Dim name As String = "MyReport"
Try
Dim stream As FileStream = File.OpenRead("MyReport.rdl")
definition = New [Byte](stream.Length - 1) {}
stream.Read(definition, 0, CInt(stream.Length - 1))
stream.Close()
Catch e As IOException
Console.WriteLine(e.Message)
End Try
Try
warnings = rs.CreateReport(name, "/Samples", False, definition, Nothing)
If Not (warnings Is Nothing) Then
Dim warning As Warning
For Each warning In warnings
Console.WriteLine(warning.Message)
Next warning
Else
Console.WriteLine("Report: {0} created successfully with no warnings", name)
End If
Catch e As SoapException
Console.WriteLine(e.Detail.InnerXml.ToString())
End Try
End Sub 'Main
End Class 'Sample
using System;
using System.IO;
using System.Web.Services.Protocols;
class Sample
{
public static void Main()
{
ReportingService2005 rs = new ReportingService2005();
rs.Credentials = System.Net.CredentialCache.DefaultCredentials;
Byte[] definition = null;
Warning[] warnings = null;
string name = "MyReport";
try
{
FileStream stream = File.OpenRead("MyReport.rdl");
definition = new Byte[stream.Length];
stream.Read(definition, 0, (int) stream.Length);
stream.Close();
}
catch(IOException e)
{
Console.WriteLine(e.Message);
}
try
{
warnings = rs.CreateReport(name, "/Samples", false, definition, null);
if (warnings != null)
{
foreach (Warning warning in warnings)
{
Console.WriteLine(warning.Message);
}
}
else
Console.WriteLine("Report: {0} created successfully with no warnings", name);
}
catch (SoapException e)
{
Console.WriteLine(e.Detail.InnerXml.ToString());
}
}
}