次の方法で共有

IHtmlTrLauncher.CHICreateHtml メソッド (Microsoft.HtmlTrans)

  • [アーティクル]

適切なクライアント アプリケーションやビューアをインストールしていないユーザーがブラウザで表示できるように、ドキュメントを HTML 形式に変換するプロセスを開始します。

名前空間: Microsoft.HtmlTrans
アセンブリ: Microsoft.HtmlTrans.Interface (microsoft.htmltrans.interface.dll 内)

構文

'宣言
Function CHICreateHtml ( _
    strLauncherUri As String, _
    rgbFile As Byte(), _
    bt As BrowserType, _
    strReqFile As String, _
    strTaskName As String, _
    timeout As Integer, _
    fReturnFileBits As Boolean _
) As CreateHtmlInfo
'使用
Dim instance As IHtmlTrLauncher
Dim strLauncherUri As String
Dim rgbFile As Byte()
Dim bt As BrowserType
Dim strReqFile As String
Dim strTaskName As String
Dim timeout As Integer
Dim fReturnFileBits As Boolean
Dim returnValue As CreateHtmlInfo

returnValue = instance.CHICreateHtml(strLauncherUri, rgbFile, bt, strReqFile, strTaskName, timeout, fReturnFileBits)

CreateHtmlInfo CHICreateHtml (
    string strLauncherUri,
    byte[] rgbFile,
    BrowserType bt,
    string strReqFile,
    string strTaskName,
    int timeout,
    bool fReturnFileBits
)

パラメータ

  • strLauncherUri
    IHtmlTrLoadBalancer インターフェイスの StrGetLauncher メソッドから返される値を使用して、ランチャー アプリケーションをホストするサーバーを指定します。
  • rgbFile
    ソース ファイルのバイナリ コンテンツ。
  • bt
    BrowserType 列挙体からの定数を使用して、対象ブラウザの種類を指定します。
  • strReqFile
    変換するドキュメントの URL。
  • strTaskName
    ドキュメント変換タスクの名前。ロード バランサはこの名前を使用して要求を追跡します。
  • timeout
    ドキュメント変換がタイムアウトになるまでの時間 (秒単位)。
  • fReturnFileBits
    CHICreateHtml メソッドから返された CreateHtmlInfo クラスのインスタンスの rgbMainFile プロパティと rgrgbThicketFiles プロパティに、変換されたファイル (つまり HTML 出力) のバイナリ コンテンツを返すかどうかを指定します。

戻り値

Microsoft.HtmlTrans.CreateHtmlInfo。変換プロセスの HTML 出力は、CreateHtmlInfo クラスのインスタンスに返されます。このインスタンスには、発生した変換エラーに関する情報と、出力に含まれる可能性がある追加の関連ファイルに関する情報も含まれます。

備考

CHICreateHtml メソッドは、ドキュメントを HTML 形式に変換するプロセスを開始し、ユーザーに転送する HTML 出力を Windows SharePoint Services に返します。

例

次のコード例に示す単純なハンドラ ページ コードでは、IHtmlTrLoadBalancer インターフェイスと IHtmlTrLauncher インターフェイスの実装を呼び出し、CHICreateHtml メソッドを使用してドキュメントを変換し、変換プロセスの結果をファイルに書き込みます。

using Microsoft.HtmlTrans;
 
void DisplayHtml(System.Web.HttpResponse response, string strLoadBalancerUri,
  string strDocument, byte[] rgbData)
{
  //generate a task name based off of the document name
  string strTask = strDocument;
 
  //create the load balancer object
  IHtmlTrLoadBalancer htmlTrLoadBalancer = (IHtmlTrLoadBalancer) 
     System.Activator.GetObject( typeof(IHtmlTrLoadBalancer), 
     strLoadBalancerUri);
 
  //get the uri for the launcher object
  string strLauncherUri = htmlTrLoadBalancer.StrGetLauncher(strTask);
 
  //create the launcher object at the uri specified by the load balancer
  IHtmlTrLauncher htmlTrLauncher = (IHtmlTrLauncher)
     System.Activator.GetObject(typeof(IHtmlTrLauncher), 
     strLauncherUri);
 
  //call the launcher to create the html
  CreateHtmlInfo chi = htmlTrLauncher.CHICreateHtml(strLauncherUri, 
    rgbData, BrowserType.BT_IE4, strDocument, strTask, 90 /*timeout*/, true);
 
  //ensure that the load balancer knows that the task has completed
  htmlTrLoadBalancer.LauncherTaskCompleted(strLauncherUri, strTask);
  
  //check for errors and output the results
  if(chi.ce == CreationErrorType.CE_NONE && chi.fHasMainFile)
     response.BinaryWrite(chi.rgbMainFile);
}

関連項目

参照

IHtmlTrLauncher インターフェイス
IHtmlTrLauncher メンバ
Microsoft.HtmlTrans 名前空間