行を削除 (プレビュー)

行を削除 [シートまたは範囲] から特定の行、すべての可視行、すべての非表示の行、または重複する行を削除するブック アクティビティ。

UiPath.Excel.Activities.DeleteRows

説明

シートまたは範囲から、特定の行、すべての可視行、すべての非表示の行、または重複する行を削除します。これは、Windows の [ 行を削除 ] アクティビティと同等のクロスプラットフォーム アクティビティです。

注:

このアクティビティでは ファイルの .xls はサポートされていません。

プロジェクトの対応 OS

Windows | クロスプラットフォーム

プロパティ

共通

• 表示名 - デザイナー パネルに表示されるアクティビティの名前です。

入力

• ファイル - リソースのブックのフル パスです。ローカル パスに切り替えるには、プラス記号のアイコンを選択し、[ローカル ファイルを使用] を選択します。現在のフィールドが [ファイル (ローカル パス)] に変更され、ブックのフル パスを指定できます。
• シート名 - ブックのシートの名前です。
• 範囲 - 行を削除する範囲です。範囲を指定しない場合、シートで使用されている範囲全体が使用されます。
• Option - 削除する行を選択します。このフィールドは必須です。既定値は [特定の行] です。以下のオプションから選択できます。
  • 特定の行 - [位置] にリストされている行を削除します。
  • すべての表示行 - 非表示になっている行をすべて削除します。
  • すべての非表示の行 - 非表示のすべての行を削除します。
  • すべての重複行 - 前の行と重複する行を、すべての列を比較して削除します。
• 位置 - 削除する行です。行番号と行範囲のコンマ区切りのリストです (例: 3, 5-7, 10)。行番号は 1 から開始され、範囲の先頭を基準にした相対位置です。このフィールドは必須であり、[ オプション] が [特定の行] の場合にのみ表示されます。

オプション

• 先頭行をヘッダーとする - 範囲の先頭行がヘッダー行である場合に選択します。ヘッダー行は、 Option の値に関係なく削除されません。既定では、このオプションは選択されていません。

  注:

  Windows の [ 行を削除 ] アクティビティとは異なり、[ 先頭行をヘッダーとする] は既定で選択されていません。

• パスワード - ブックのパスワードです (必要な場合)。

出力

• 削除された行 - アクティビティによって削除された行の数です。 Int32 型変数に格納されます。

ブックを使用する

• ブック - ファイル パスの代わりに使用する既存のブックです。

備考

• [位置] の行番号は、任意の順序にしたり、重複したり、反転したりできます。たとえば、 10-8 は と同じ 8-10です。各行は削除され、1 回カウントされます。
• [ 位置] が空であるか有効なリストではない場合、または位置が 1 より小さいか、範囲の最後の行を超えている場合、アクティビティは失敗し、何も削除されません。
• 削除された行の下の行は、ギャップを埋めるために上に移動します。
• 範囲が使用範囲全体をカバーしている場合、各行の非表示または表示状態はシフトとともに移動します。範囲がシートよりも狭い場合、行の表示は変更されません。これは行全体のプロパティであるためです。例外は 、すべての非表示の行です。各行は削除される直前に再度表示されるため、上にシフトしたデータが非表示のままになることはありません。これにより、範囲外の行の他のデータも表示されます。
• A:Aなどの列全体または行全体の範囲は、シートで使用される範囲に制限されます。
• 範囲は [シート名] のシートを参照する必要があります。Sheet2!A1:A10などのシート名を含む範囲はサポートされていないため、エラーが発生します。