SPFile.Convert method

發行項
05/05/2015

NOTE: This API is now obsolete.

轉換使用指定的轉換程式的檔案。

Namespace: Microsoft.SharePoint
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)

Syntax

'宣告
<ObsoleteAttribute("This member is obsolete - use the specialized Office services instead",  _
    False)> _
Public Function Convert ( _
    ConverterId As Guid, _
    newFileName As String, _
    configInfo As String, _
    handlerAssembly As String, _
    handlerClass As String, _
    priority As Byte, _
    peopleToAlert As String, _
    sendACopy As Boolean, _
    synchronous As Boolean, _
    <OutAttribute> ByRef workItemId As Guid _
) As SPFileConversionResult
'用途
Dim instance As SPFile
Dim ConverterId As Guid
Dim newFileName As String
Dim configInfo As String
Dim handlerAssembly As String
Dim handlerClass As String
Dim priority As Byte
Dim peopleToAlert As String
Dim sendACopy As Boolean
Dim synchronous As Boolean
Dim workItemId As Guid
Dim returnValue As SPFileConversionResult

returnValue = instance.Convert(ConverterId, _
    newFileName, configInfo, handlerAssembly, _
    handlerClass, priority, peopleToAlert, _
    sendACopy, synchronous, workItemId)

[ObsoleteAttribute("This member is obsolete - use the specialized Office services instead", 
    false)]
public SPFileConversionResult Convert(
    Guid ConverterId,
    string newFileName,
    string configInfo,
    string handlerAssembly,
    string handlerClass,
    byte priority,
    string peopleToAlert,
    bool sendACopy,
    bool synchronous,
    out Guid workItemId
)

參數

ConverterId
Type: System.Guid

System.Guid物件，識別要用來轉換文件特定的文件轉換程式。

newFileName
Type: System.String

字串，包含要建立檔案的分葉名稱。轉換程式所時，會自動加上副檔名。

configInfo
Type: System.String

字串，包含要求這個轉換時，會傳遞至轉換應用程式的組態資訊。資訊是轉換應用程式專用的且可以是空字串或 null 參考 (在 Visual Basic 的Nothing )。

handlerAssembly
Type: System.String

選擇性的。字串，指定要載入的組件。與handlerClass參數，您可以指定預先轉換或轉換後的處理常式，以叫用之前或之後執行轉換後的內容，不同的工作，而不是只需要把它變成檔案的轉換架構轉換。這個參數的值可以是a null reference (Nothing in Visual Basic)。

handlerClass
Type: System.String

選擇性的。字串，指定要具現化類別在handlerAssembly參數所指定的組件中定義。類別必須實作ISPConversionProcessor介面和方法。與handlerAssembly參數，您可以指定預先轉換或轉換後的處理常式，以叫用之前或之後執行轉換後的內容，不同的工作，而不是只需要把它變成檔案的轉換架構轉換。這個參數的值可以是 null 參考 (在 Visual Basic 的Nothing )。