OracleBulkCopyColumnMappingCollection
クラスは、データ・ソースの列を保存先表の列にマップするために使用するOracleBulkCopyColumnMapping
オブジェクトのコレクションを表します。
クラスの継承
System.Object
System.CollectionBase
System.OracleBulkCopyColumnMappingCollection
宣言
// C# public sealed class OracleBulkCopyColumnMappingCollection : CollectionBase
スレッド安全性
パブリック静的メソッドはスレッドセーフですが、インスタンス・メソッドではスレッド安全性は保証されません。
備考
列のマッピングにより、データ・ソースとターゲット表間のマッピングが定義されます。
データ・ソース内のすべての列に対して列マッピングを指定する必要はありません。ColumnMapping
が指定されていない場合は、デフォルトでは、順序位置に基づいて列がマップされます。これはソースと保存先の表スキーマが一致している場合のみ実行されます。一致しない場合はInvalidOperationException
がスローされます。
マッピング・コレクション内のすべてのマッピングは、名前また順序位置ごとに行われる必要があります。
注意: Oracle Data Provider for .NETでは、順序位置でマッピングが指定されている場合は、列名を判別するためにデータベースへのラウンドトリップが1回以上作成されます。このパフォーマンスのオーバーヘッドを回避するには、列名でマッピングを指定してください。 |
例
// C#
要件
ネームスペース: Oracle.DataAccess.Client
アセンブリ: Oracle.DataAccess.dll
Microsoft .NET Framework Version: 2.0以降
OracleBulkCopyColumnMappingCollection
メンバーは次の表にリスト表示されています。
OracleBulkCopyColumnMappingCollectionプロパティ
OracleBulkCopyColumnMappingCollection
プロパティを、表17-11にリストします。
表17-11 OracleBulkCopyColumnMappingCollectionプロパティ
プロパティ | 説明 |
---|---|
|
指定された索引にある |
OracleBulkCopyColumnMappingCollectionパブリック・メソッド
OracleBulkCopyColumnMappingCollection
パブリック・メソッドを、表17-12にリストします。
表17-12 OracleBulkCopyColumnMappingCollectionパブリック・メソッド
パブリック・メソッド | 説明 |
---|---|
|
オブジェクトをコレクションに追加します |
|
コレクションの内容をクリアします |
|
指定された |
|
|
|
指定された |
|
指定された索引にあるコレクションに新規の |
|
|
|
指定された索引にあるコレクションからマッピングを削除します。 |
OracleBulkCopyColumnMappingCollection
プロパティを、表17-13にリストします。
表17-13 OracleBulkCopyColumnMappingCollectionプロパティ
プロパティ | 説明 |
---|---|
|
指定された索引にある |
このプロパティは、指定された索引にあるOracleBulkCopyColumnMapping
オブジェクトを取得または設定します。
宣言
// C#
public OracleBulkCopyColumnMapping this[int index] {get;set;}
パラメータ
index
設定または取得されるOracleBulkCopyColumnMapping
のゼロベースの索引。
プロパティ値
指定された索引にあるOracleBulkCopyColumnMapping
オブジェクト。
例外
IndexOutOfRangeException
: 指定された索引は存在しません。
OracleBulkCopyColumnMappingCollection
パブリック・メソッドを、表17-14にリストします。
表17-14 OracleBulkCopyColumnMappingCollectionパブリック・メソッド
パブリック・メソッド | 説明 |
---|---|
|
オブジェクトをコレクションに追加します |
|
コレクションの内容をクリアします |
|
指定された |
|
|
|
指定された |
|
指定された索引にあるコレクションに新規の |
|
|
|
指定された索引にあるコレクションからマッピングを削除します。 |
Addメソッドでは、オブジェクトがコレクションに追加されます。
オーバーロード・リスト:
Add(OracleBulkCopyColumnMapping)
このメソッドでは、指定されたOracleBulkCopyColumnMapping
オブジェクトがコレクションに追加されます。
このメソッドは、OracleBulkCopyColumnMapping
オブジェクトを作成し、指定されたソースおよび保存先列の順序位置を使用してコレクションに追加します。
このメソッドは、OracleBulkCopyColumnMapping
オブジェクトを作成し、指定されたソース列の順序および保存先列名を使用してコレクションに追加します。
このメソッドは、OracleBulkCopyColumnMapping
オブジェクトを作成し、指定されたソース列名および保存先列の順序を使用してコレクションに追加します。
このメソッドは、OracleBulkCopyColumnMapping
オブジェクトを作成し、指定されたソースおよび保存先列名を使用してコレクションに追加します。
このメソッドでは、指定されたOracleBulkCopyColumnMapping
オブジェクトがコレクションに追加されます。
宣言
// C#
public OracleBulkCopyColumnMapping Add(OracleBulkCopyColumnMapping bulkCopyColumnMapping);
パラメータ
bulkCopyColumnMapping
コレクションに追加されるマッピングを示すOracleBulkCopyColumnMapping
オブジェクト。
例外
InvalidOperationException
: 一括コピー操作が実行中です。
このメソッドは、OracleBulkCopyColumnMapping
オブジェクトを作成し、指定されたソースおよび保存先列の順序位置を使用してコレクションに追加します。
宣言
// C# public OracleBulkCopyColumnMapping Add(int sourceColumnIndex, int destinationColumnIndex);
パラメータ
sourceColumnIndex
データ・ソース内のソース列の順序位置。
destinationColumnIndex
保存先表内の保存先列の順序位置。
例外
InvalidOperationException
: 一括コピー操作が実行中です。
戻り値
コレクションに追加された新規作成のOracleBulkCopyColumnMapping
オブジェクト。
備考
データ・ソース内のすべての列に対して列マッピングを指定する必要はありません。ColumnMapping
が指定されていない場合は、デフォルトでは、順序位置に基づいて列がマップされます。これはソースと保存先の表スキーマが一致している場合のみ実行されます。一致しない場合はInvalidOperationException
がスローされます。
マッピング・コレクション内のすべてのマッピングは、名前また順序位置ごとに行われる必要があります。
注意: Oracle Data Provider for .NETでは、順序位置でマッピングが指定されている場合は、列名を判別するためにデータベースへのラウンドトリップが1回以上作成されます。このパフォーマンスのオーバーヘッドを回避するには、列名でマッピングを指定してください。 |
このメソッドは、OracleBulkCopyColumnMapping
オブジェクトを作成し、指定されたソース列の順序および保存先列名を使用してコレクションに追加します。
宣言
// C# public OracleBulkCopyColumnMapping Add(int sourceColumnIndex, string destinationColumn);
パラメータ
sourceColumnIndex
データ・ソース内のソース列の順序位置。
destinationColumn
保存先表内の保存先列名。
例外
InvalidOperationException
: 一括コピー操作が実行中です。
戻り値
コレクションに追加された新規作成のOracleBulkCopyColumnMapping
オブジェクト。
備考
データ・ソース内のすべての列に対して列マッピングを指定する必要はありません。ColumnMapping
が指定されていない場合は、デフォルトでは、順序位置に基づいて列がマップされます。これはソースと保存先の表スキーマが一致している場合のみ実行されます。一致しない場合はInvalidOperationException
がスローされます。
マッピング・コレクション内のすべてのマッピングは、名前また順序位置ごとに行われる必要があります。
注意: Oracle Data Provider for .NETでは、パフォーマンスのオーバーヘッドを引き起こす順序でマッピングが指定されている場合は、列名を判別するためにデータベースへのラウンドトリップが1回以上作成されます。このため、列名でマッピングを指定することをお薦めします。 |
このメソッドは、OracleBulkCopyColumnMapping
オブジェクトを作成し、指定されたソース列名および保存先列の順序を使用してコレクションに追加します。
宣言
// C# public OracleBulkCopyColumnMapping Add(string sourceColumn, int destinationColumnIndex);
パラメータ
sourceColumn
データ・ソース内のソース列名。
destinationColumnIndex
保存先表内の保存先列の順序位置。
戻り値
コレクションに追加された新規作成のOracleBulkCopyColumnMapping
オブジェクト。
例外
InvalidOperationException
: 一括コピー操作が実行中です。
備考
データ・ソース内のすべての列に対して列マッピングを指定する必要はありません。ColumnMapping
が指定されていない場合は、デフォルトでは、順序位置に基づいて列がマップされます。これはソースと保存先の表スキーマが一致している場合のみ実行されます。一致しない場合はInvalidOperationException
がスローされます。
マッピング・コレクション内のすべてのマッピングは、名前また順序位置ごとに行われる必要があります。
注意: Oracle Data Provider for .NETでは、パフォーマンスのオーバーヘッドを引き起こす順序でマッピングが指定されている場合は、列名を判別するためにデータベースへのラウンドトリップが1回以上作成されます。このため、列名でマッピングを指定することをお薦めします。 |
このメソッドは、OracleBulkCopyColumnMapping
オブジェクトを作成し、指定されたソースおよび保存先列名を使用してコレクションに追加します。
宣言
// C# public OracleBulkCopyColumnMapping Add(string sourceColumn, string destinationColumn);
パラメータ
sourceColumn
データ・ソース内のソース列名。
destinationColumn
保存先表内の保存先列名。
例外
InvalidOperationException
: 一括コピー操作が実行中です。
戻り値
コレクションに追加された新規作成のOracleBulkCopyColumnMapping
オブジェクト。
備考
データ・ソース内のすべての列に対して列マッピングを指定する必要はありません。ColumnMapping
が指定されていない場合は、デフォルトでは、順序位置に基づいて列がマップされます。これはソースと保存先の表スキーマが一致している場合のみ実行されます。一致しない場合はInvalidOperationException
がスローされます。
マッピング・コレクション内のすべてのマッピングは、名前また順序位置ごとに行われる必要があります。
注意: Oracle Data Provider for .NETでは、順序位置でマッピングが指定されている場合は、列名を判別するためにデータベースへのラウンドトリップが1回以上作成されます。このパフォーマンスのオーバーヘッドを回避するには、列名でマッピングを指定してください。 |
このメソッドでは、コレクションの内容がクリアされます。
宣言
// C# public void Clear();
例外
InvalidOperationException
: 一括コピー操作が実行中です。
備考
Clear
メソッドは、アプリケーションが単一のOracleBulkCopy
インスタンスを使用して1つ以上の一括コピー操作を処理する場合に最も使用します。列マッピングが1度の一括コピー操作のために作成される場合、OracleBulkCopyColumnMappingCollection
は、WriteToServer
メソッドの呼出し後、および次回の一括コピーの前にクリアされる必要があります。
各操作に対して個別のOracleBulkCopy
を使用するより、同じOracleBulkCopy
インスタンスを使用して複数の一括コピーを実行する方が効率的です。
このメソッドは、指定されたOracleBulkCopyColumnMapping
オブジェクトがコレクション内に存在するかどうかを示す値を戻します。
宣言
// C#
public bool Contains(OracleBulkCopyColumnMapping value);
パラメータ
value
有効なOracleBulkCopyColumnMapping
オブジェクト。
戻り値
指定されたマッピングがコレクションに存在する場合はtrue
を、存在しない場合はfalse
を戻します。
このメソッドでは、OracleBulkCopyColumnMappingCollection
の要素が、指定された索引で始まるOracleBulkCopyColumnMapping
項目の配列にコピーされます。
宣言
// C# public void CopyTo(OracleBulkCopyColumnMapping[] array, int index);
パラメータ
array
OracleBulkCopyColumnMappingCollection
オブジェクトからコピーされた要素の保存先である1次元のOracleBulkCopyColumnMapping
配列。配列はゼロベースの索引を持つ必要があります。
index
コピーが開始するゼロベース配列の索引。
このメソッドは、指定されたOracleBulkCopyColumnMapping
オブジェクトの索引を戻します。
宣言
// C#
public int IndexOf(OracleBulkCopyColumnMapping value);
パラメータ
value
戻されるOracleBulkCopyColumnMapping
オブジェクト。
戻り値
列マッピングがコレクション内にない場合のゼロベースの列マッピングの索引または-1。
このメソッドは、指定された索引にあるコレクションに新規のOracleBulkCopyColumnMapping
オブジェクトを挿入します。
宣言
// C# public void Insert(int index, OracleBulkCopyColumnMapping value);
パラメータ
index
新規のOracleBulkCopyColumnMapping
が挿入されるOracleBulkCopyColumnMappingCollection
内の位置の整数値。
value
コレクションに挿入されるOracleBulkCopyColumnMapping
オブジェクト。
例外
InvalidOperationException
: 一括コピー操作が実行中です。
このメソッドは、OracleBulkCopyColumnMappingCollection
から指定されたOracleBulkCopyColumnMapping
要素を削除します。
宣言
// C#
public void Remove(OracleBulkCopyColumnMapping value);
パラメータ
value
コレクションから削除されるOracleBulkCopyColumnMapping
オブジェクト。
例外
InvalidOperationException
: 一括コピー操作が実行中です。
備考
Remove
メソッドは、OracleBulkCopy
インスタンスが1つ以上の一括コピー操作を処理する場合に最も使用します。列マッピングが1度の一括コピー操作のために作成される場合、適用されないマッピングはWriteToServer
メソッドの呼出し後および次回の一括コピー用にマッピングが定義される前に削除する必要があります。Clear
メソッドはコレクション全体をクリアし、Remove
およびRemoveAt
メソッドは個々のマッピングを削除します。
各操作に対して個別のOracleBulkCopy
を使用するより、同じOracleBulkCopy
インスタンスを使用して複数の一括コピーを実行する方が効率的です。
このメソッドは、指定された索引にあるコレクションからマッピングを削除します。
宣言
// C#
public void RemoveAt(int index);
パラメータ
index
コレクションから削除されるOracleBulkCopyColumnMapping
オブジェクトのゼロベースの索引。
例外
InvalidOperationException
: 一括コピー操作が実行中です。
備考
RemoveAt
メソッドは、OracleBulkCopy
インスタンスが1つ以上の一括コピー操作を処理する場合に最も使用します。列マッピングが1度の一括コピー操作のために作成される場合、適用されないマッピングはWriteToServer
メソッドの呼出し後および次回の一括コピー用にマッピングが定義される前に削除する必要があります。Clear
メソッドはコレクション全体をクリアし、Remove
およびRemoveAt
メソッドは個々のマッピングを削除します。
各操作に対して個別のOracleBulkCopy
を使用するより、同じOracleBulkCopy
インスタンスを使用して複数の一括コピーを実行する方が効率的です。