FileSavePicker Class

사용자가 파일의 파일 이름, 확장명 및 저장소 위치를 선택할 수 있는 파일 선택을 나타냅니다.

구문


var fileSavePicker = new Windows.Storage.Pickers.FileSavePicker();

특성

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

멤버

FileSavePicker클래스에는 다음과 같은 형식의 멤버가 있습니다.

생성자

FileSavePicker클래스에는 다음과 같은 생성자가 있습니다.

생성자Description
FileSavePicker Creates a new instance of a FileSavePicker.

 

메서드

The FileSavePicker 클래스 - 이러한 메서드가 있습니다. C#, Visual Basic 및 C++에서는 다음 위치의 메서드도 상속합니다. Object 클래스.

메서드Description
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클래스 - 이러한 속성이 있습니다.

속성사용 권한Description

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.

 

설명

파일 선택기를 통해 파일을 저장하는 방법을 보려면 파일 선택기를 통해 파일을 저장하는 방법을 참조하십시오.

파일 및 폴더 파일 선택기에 대한 액세스를 시작하려면 빠른 시작: 파일 선택기로 파일에 액세스를 참조하십시오.

경고  앱이 맞춰진 동안 파일 선택기를 표시하려고 하면 파일 선택기가 표시되지 않고 예외가 throw됩니다. 파일 선택기를 호출하기 전에 앱이 기본 뷰로 맞춰지지 않았는지 확인하거나 앱을 맞춤 해제하여 이를 방지할 수 있습니다. 다음 코드 예제와 파일 선택기 샘플에서는 방법을 보여 줍니다.

예제

파일 선택기 샘플에서는 앱을 끌어왔는지 여부를 확인하는 방법, 파일 선택기 속성을 설정하는 방법, 그리고 사용자가 파일을 선택할 수 있도록 파일 선택기를 표시하는 방법을 보여 줍니다.


// Verify that we are currently not snapped, or that we can unsnap to open the picker
var currentState = Windows.UI.ViewManagement.ApplicationView.value;
if (currentState === Windows.UI.ViewManagement.ApplicationViewState.snapped &&
    !Windows.UI.ViewManagement.ApplicationView.tryUnsnap()) {
    // Fail silently if we can't unsnap
    return;
}

// Create the picker object and set options
var savePicker = new Windows.Storage.Pickers.FileSavePicker();
savePicker.suggestedStartLocation = Windows.Storage.Pickers.PickerLocationId.documentsLibrary;
// Dropdown of file types the user can save the file as
savePicker.fileTypeChoices.insert("Plain Text", [".txt"]);
// Default file name if the user does not type one in or select a file to replace
savePicker.suggestedFileName = "New Document";

savePicker.pickSaveFileAsync().then(function (file) {
    if (file) {
        // Prevent updates to the remote version of the file until we finish making changes and call CompleteUpdatesAsync.
        Windows.Storage.CachedFileManager.deferUpdates(file);
        // write to file
        Windows.Storage.FileIO.writeTextAsync(file, file.name).done(function () {
            // Let Windows know that we're finished changing the file so the other app can update the remote version of the file.
            // Completing updates may require Windows to ask for user input.
            Windows.Storage.CachedFileManager.completeUpdatesAsync(file).done(function (updateStatus) {
                if (updateStatus === Windows.Storage.Provider.FileUpdateStatus.complete) {
                    WinJS.log && WinJS.log("File " + file.name + " was saved.", "sample", "status");
                } else {
                    WinJS.log && WinJS.log("File " + file.name + " couldn't be saved.", "sample", "status");
                }
            });
        });
    } else {
        WinJS.log && WinJS.log("Operation cancelled.", "sample", "status");
    }
});


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 스토어 앱만]

Namespace

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

Metadata

Windows.winmd

참고 항목

파일 선택기 샘플
빠른 시작: 파일 선택기로 파일에 액세스
파일 선택기를 통해 파일을 저장하는 방법
Windows.Storage.StorageFile class

 

 

표시:
© 2014 Microsoft