ReportingService2005.CancelBatch メソッド

定義

名前空間:: ReportService2005

アセンブリ:: ReportService2005.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

CreateBatch()メソッドへの呼び出しによって開始されたバッチをキャンセルします。

public:
 void CancelBatch();

public void CancelBatch();

member this.CancelBatch : unit -> unit

Public Sub CancelBatch ()

例

このコード例をコンパイルするには、Reporting Services Web Service Description Language(WSDL)を参照し、特定の名前空間をインポートする必要があります。詳細については、「コード例のコンパイルと実行」をご覧ください。以下のコード例はバッチをキャンセルし、実行を試み、エラー詳細を表示します。

Imports System  
Imports System.Web.Services.Protocols  

Class Sample  
   Public Shared Sub Main()  
      Dim rs As New ReportingService2005()  
      rs.Credentials = System.Net.CredentialCache.DefaultCredentials  

      Dim bh As New BatchHeader()  
      bh.BatchID = rs.CreateBatch()  
      rs.BatchHeaderValue = bh  
      rs.CreateFolder("New Folder1", "/", Nothing)  
      rs.CreateFolder("New Folder2", "/", Nothing)  
      rs.CreateFolder("New Folder3", "/", Nothing)  

      Console.WriteLine("Cancelling current batch operation.")  

      ' Cancel the current batch.  
      Try  
         rs.CancelBatch()  

      Catch e As SoapException  
         Console.WriteLine(e.Detail.InnerXml.ToString())  
      End Try  

      Try  
         ' Generates an error because the batch has already been cancelled.  
         rs.ExecuteBatch()  
         Console.WriteLine("The batch executed successfully.")  

      Catch e As SoapException  
         Console.WriteLine(e.Detail.InnerXml.ToString())  
         Console.WriteLine("The batch was not executed.")  

      Finally  
         rs.BatchHeaderValue = Nothing  
      End Try  
   End Sub 'Main  
End Class 'Sample

using System;  
using System.Web.Services.Protocols;  

class Sample  
{  
   public static void Main()  
   {  
      ReportingService rs = new ReportingService2005();  
      rs.Credentials = System.Net.CredentialCache.DefaultCredentials;  

      BatchHeader bh = new BatchHeader();  
      bh.BatchID = rs.CreateBatch();  
      rs.BatchHeaderValue = bh;  
      rs.CreateFolder("New Folder1", "/", null);  
      rs.CreateFolder("New Folder2", "/", null);  
      rs.CreateFolder("New Folder3", "/", null);  

      Console.WriteLine("Cancelling current batch operation.");  

      // Cancel the current batch.  
      try  
      {  
         rs.CancelBatch();  
      }  

      catch (SoapException e)  
      {  
         Console.WriteLine(e.Detail.InnerXml.ToString());  
      }  

      try  
      {  
         // Generates an error because the batch has already been cancelled.  
         rs.ExecuteBatch();  
         Console.WriteLine("The batch executed successfully.");  
      }  

      catch (SoapException e)  
      {  
         Console.WriteLine(e.Detail.InnerXml.ToString());  
         Console.WriteLine("The batch was not executed.");  
      }  

      finally  
      {  
         rs.BatchHeaderValue = null;  
      }  
   }  
}

注釈

以下の表は、この操作のヘッダーおよび権限情報を示しています。


SOAPヘッダー	(イン) BatchHeaderValue (アウト) ServerInfoHeaderValue
必要なアクセス許可	ユーザーはデータベース管理者であるか、無人実行アカウントとして設定されている管理者でなければなりません。詳細は実行アカウント(SSRSネイティブモード)をご覧ください。

CancelBatchメソッドを呼び出す前に、キャンセルしたいバッチのIDを指定する必要があります。これは、Report Server Webサービスの BatchHeaderValue プロパティを、バッチ作成時に生成されたバッチIDの値に設定することで可能です。

CancelBatchメソッドが呼び出されると、バッチIDに関連付けられたメソッド呼び出しはもはや実行できなくなります。キャンセルされたバッチIDでバッチを実行しようとする試みは、エラーコード rsBatchNotFoundを含むSOAP例外が発生します。

適用対象

こちらもご覧ください

ExecuteBatch()