IStorageItem2.IsEqual(IStorageItem) メソッド

定義

現在のアイテムが指定した項目と同じかどうかを示します。

public:
 bool IsEqual(IStorageItem ^ item);
bool IsEqual(IStorageItem const& item);
public bool IsEqual(IStorageItem item);
function isEqual(item)
Public Function IsEqual (item As IStorageItem) As Boolean

パラメーター

item
IStorageItem

比較対象のストレージ項目を表す IStorageItem オブジェクト。

戻り値

Boolean

bool

現在のストレージ項目が指定したストレージ項目と同じ場合は true を返します。それ以外の場合 は false

注釈

IsEqual メソッドを使用して、2 つのストレージ項目が同じファイルまたはフォルダーを表しているかどうかを判断します。

このメソッドは、両方の項目の Path プロパティを比較して、それらが同じかどうかを判断します。 パスがない場合 (アイテムがライブラリの場合など)、またはパスが一致しない場合は、IShellItem.Compare を使用して項目が比較されます。

この例では、2 つのストレージ ファイルを比較して等価にする方法を示します。

function openNewFile() {
    var picker = new Windows.Storage.Pickers.FileOpenPicker;
    picker.fileTypeFilter.replaceAll(["*"]);
    picker.pickSingleFileAsync().then(function (file) {
        var alreadyOpenedFile = null;
        _openFiles.some(function (openFile) {
            if (file.IsEqual(openFile.file)) {
                alreadyOpenedFile = openFile;
                return true;
            }
            return false;
        });

        if (alreadyOpenedFile != null) {
            alreadyOpenedFile.window.activate();
        } else {
            createNewFileViewerWindow(file);
        }
    });
}

適用対象

こちらもご覧ください