FileSavePicker Class

代表可讓使用者選擇檔案名稱、 副檔名以及檔案儲存位置的檔案選擇器。

語法


public ref class FileSavePicker sealed 

屬性

[Muse()]
[Version(0x06020000)]

成員

FileSavePicker類別 具有下列類型的成員:

建構函式

FileSavePicker類別 具有這些建構函式。

建構函式描述
FileSavePicker Creates a new instance of a FileSavePicker.

 

方法

The FileSavePicker 類別 擁有這些方法。 使用 C#、Visual Basic 和 C++,它也會繼承方法自Object 類別.

方法描述
PickSaveFileAsync Shows the file picker so that the user can save a file and set the file name, extension, and location of the file to be saved.

 

屬性

FileSavePicker類別 擁有這些屬性。

屬性存取類型描述

CommitButtonText

讀取/寫入Gets or sets the label text of the commit button in the file pickerUI.

DefaultFileExtension

讀取/寫入Gets or sets the default file name extension that the fileSavePicker gives to files to be saved.

FileTypeChoices

唯讀Gets the collection of valid file types that the user can choose to assign to a file.

SettingsIdentifier

讀取/寫入Gets or sets the settings identifier associated with the current FileSavePicker instance.

SuggestedFileName

讀取/寫入Gets or sets the file name that the file save picker suggests to the user.

SuggestedSaveFile

讀取/寫入Gets or sets the storageFile that the file picker suggests to the user for saving a file.

SuggestedStartLocation

讀取/寫入Gets or sets the location that the file save picker suggests to the user as the location to save a file.

 

備註

若要了解如何透過檔案選擇器儲存檔案,請參閱如何透過檔案選擇器儲存檔案

若要開始存取檔案和資料夾檔案選擇器,請參閱快速入門:使用檔案選擇器存取檔案

警告  如果您嘗試在應用程式貼齊時顯示檔案選擇器,檔案選擇器將不會顯示,而且會擲回例外狀況。您可以藉由確保應用程式不會貼齊或是在呼叫檔案選擇器之前取消貼齊的方式,避免這種情況發生。 下列程式碼範例和檔案選擇器範例會示範使用方式。

範例

檔案選擇器範例示範如何檢查應用程式是否貼齊,如何設定檔案選擇器屬性,以及如何顯示檔案選擇器,讓使用者可以儲存檔案。

No code example is currently available or this language may not be supported.

使用 C# 時,檔案選擇器範例示範如何檢查應用程式是否在 EnsureUnsnapped 方法中貼齊。


internal bool EnsureUnsnapped()
{
    // FilePicker APIs will not work if the application is in a snapped state.
    // If an app wants to show a FilePicker while snapped, it must attempt to unsnap first
    bool unsnapped = ((ApplicationView.Value != ApplicationViewState.Snapped) || ApplicationView.TryUnsnap());
    if (!unsnapped)
    {
        NotifyUser("Cannot unsnap the sample.", NotifyType.StatusMessage);
    }

    return unsnapped;
}


需求

支援的最小用戶端

Windows 8 [僅限 Windows 市集應用程式]

支援的最小伺服器

Windows Server 2012 [僅限 Windows 市集應用程式]

命名空間

Windows.Storage.Pickers
Windows::Storage::Pickers [C++]

Metadata

Windows.winmd

請參閱

檔案選擇器範例
快速入門:使用檔案選擇器存取檔案
如何透過檔案選擇器儲存檔案
Windows.Storage.StorageFile class

 

 

顯示:
© 2014 Microsoft