MergeWith（PDFFile［］、String）メソッド

C#
Visual Basic
Objective-C
Java
C++

public void MergeWith( 
   PDFFile[] sourceFiles,
   string destinationFileName
)

'Declaration

Public Overloads Sub MergeWith( _
   ByVal sourceFiles() As PDFFile, _
   ByVal destinationFileName As String _
)

'Usage

Dim instance As PDFFile
Dim sourceFiles() As PDFFile
Dim destinationFileName As String
 
instance.MergeWith(sourceFiles, destinationFileName)

public:
void MergeWith( 
   array<PDFFile^>^ sourceFiles,
   String^ destinationFileName
)

パラメーター

sourceFiles: 名前を格納するPDFFileオブジェクトの配列とこのPDFFileで結合するソースファイルのオプションのパスワード。nullであってはならなくて、少なくとも1つの項目と最高100の項目を格納しなければなりません。
destinationFileName: 作成されるデスティネーションPDFファイルの名前。このパラメーターの値がnullであるならば、そして、FileNameで設定されるファイル名は、更新されます。

このメソッドは、既存のPDFファイルからすべてのページを格納している新しいファイルを作るために、2部以上の既存のPDFファイルを結合します。新しいファイルは、以下のように構築されます：

オブジェクトが最初にそうであるだろうこのPDFFileに関連づけられるPDFファイルのページ。
sourceFilesリストの最初のファイルのページは、次に追加されます
sourceFilesリストの第2のファイルのページは、次に追加されます
そして、sourceFilesの各項目のためのその他。

すべてのPDFファイルはディスク上で先在しなければならなくて、有効でなければなりません。sourceFilesパラメーターは、任意の無効な項目を格納してはいけません。

このメソッドを使うために、有効なPDFファイルとオプションのパスワードでこのPDFFileオブジェクトを関連付けます。PDFFile（string fileName）またはPDFFile（string fileName、stringパスワード）コンストラクタを用いてどちらによってでもこれを達成することができるか、FileNameとパスワードプロパティに直接ファイル名とオプションのパスワードを設定することができます。このメソッドを使う前にロードを呼び出す必要はありません。

このメソッドでは、このPDFFileオブジェクトの以下のプロパティを使用します。

DocumentProperties.このプロパティの値がnullであるならば、デフォルトのプロパティが使われます
SecurityOptions.このプロパティの値がnullでないならば、行き先ファイルはこのプロパティのプロパティを使用して暗号化されます。このプロパティの値がnullであるならば、結果ファイルは暗号化されません
CompatibilityLevel.生成されるPDFファイルのバージョン

結合するファイルの一つ以上がパスワードで暗号化されるならば、sourceFiles配列でそのPDFFile項目で必須のパスワードを設定します。ファイルのどれも暗号化されないならば、代わりにファイル名のためにSystem.Stringのリストを渡すことができるこのメソッドのMergeWith（string［］sourceFileNames、string destinationFileName）バージョンを使うことができます。

サンプルのために、参照しますMergeWith。

ターゲットプラットホーム

参照

PDFFileクラス
 PDFFileメンバ
 オーバーロードリスト