StorageLibrary.AreFolderSuggestionsAvailableAsync Метод

Определение

Пространство имен:

Windows.Storage

Определяет, есть ли предложения по добавлению существующих папок с содержимым в StorageLibrary.

public:
 virtual IAsyncOperation<bool> ^ AreFolderSuggestionsAvailableAsync() = AreFolderSuggestionsAvailableAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<bool> AreFolderSuggestionsAvailableAsync();

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<bool> AreFolderSuggestionsAvailableAsync();

function areFolderSuggestionsAvailableAsync()

Public Function AreFolderSuggestionsAvailableAsync () As IAsyncOperation(Of Boolean)

Возвращаемое значение

IAsyncOperation<Boolean>

IAsyncOperation<bool>

Значение true , если есть варианты папок; Значение false, в противном случае

Атрибуты

RemoteAsyncAttribute

Требования к Windows

Семейство устройств	Windows 10 Fall Creators Update (появилось в 10.0.16299.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v5.0)

Примеры

В этом примере показано, как определить, есть ли предлагаемые папки с содержимым, которые можно добавить в библиотеку изображений.

private async Task<StorageLibrary> SetupPicturesLibraryAsync()
{
    if (this.picturesLibrary == null)
    {
        this.picturesLibrary = await StorageLibrary.GetLibraryAsync(KnownLibraryId.Pictures);
        this.picturesLibrary.DefinitionChanged += PicturesLibrary_DefinitionChanged;
    }
    return this.picturesLibrary;
}

private async void CheckForFolderSuggestions_Clicked(object sender, RoutedEventArgs e)
{
    var library = await SetupPicturesLibraryAsync();

    if (await library.AreFolderSuggestionsAvailableAsync())
    {
        // There are new folders that could be added to the library.
        // Prompt the user to add one or more of them. 

        // Note that the RequestAddFolderAsync method returns only one folder.
        // If the user adds multiple folders, only one will be returned.
        // In this example, to keep track of all the added folders, the app can subscribe to the
        // StorageLibrary.DefinitionChanged event by awaiting library.RequestAddFolderAsync();

        // Launch the folder suggestion dialog
        var folder = await library.RequestAddFolderAsync(); 
    }
}

private void PicturesLibrary_DefinitionChanged(StorageLibrary sender, object args)
{
    foreach (StorageFolder folder in sender.Folders)
    {
        // Do something with every folder in the library
    }
}

Примечание

Не забудьте включить возможность picturesLibrary в манифест пакета приложения. Дополнительные сведения о возможностях в манифесте см. в разделе Объявления возможностей приложения.

Комментарии

Если эта функция не поддерживается в вашей версии Windows, метод возвращает значение false.