StorageFile.IsEqual(IStorageItem) メソッド

定義

現在のファイルが指定したファイルと等しいかどうかを示します。

public:
 virtual bool IsEqual(IStorageItem ^ item) = IsEqual;
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);
        }
    });
}

適用対象

こちらもご覧ください