피드백

FileSavePicker 클래스

  • 참조

정의

네임스페이스:
Windows.Storage.Pickers
편집

사용자가 파일의 파일 이름, 확장명 및 스토리지 위치를 선택할 수 있는 파일 선택기를 나타냅니다.

데스크톱 앱에서 UI를 표시하는 방식으로 이 클래스의 인스턴스를 사용하기 전에 개체를 소유자의 창 핸들과 연결해야 합니다. 자세한 정보 및 코드 예제는 CoreWindow에 의존하는 WinRT UI 개체 표시를 참조하세요.

public ref class FileSavePicker sealed
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class FileSavePicker final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class FileSavePicker final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class FileSavePicker final
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class FileSavePicker
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class FileSavePicker
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class FileSavePicker
function FileSavePicker()
Public NotInheritable Class FileSavePicker
상속
Object IInspectable FileSavePicker
특성
ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 요구 사항

디바이스 패밀리
Windows 10 (10.0.10240.0에서 도입되었습니다.)
API contract
Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)

예제

파일 선택기 샘플은 C# 및 C++/WinRT 버전에서 사용할 수 있습니다. 앱이 스냅되었는지 여부, 파일 선택기 속성을 설정하는 방법 및 사용자가 파일을 저장할 수 있도록 파일 선택기를 표시하는 방법을 보여 줍니다.

다음은 samle 앱의 C# 버전에서 발췌한 내용입니다.

if (rootPage.EnsureUnsnapped())
{
    FileSavePicker savePicker = new FileSavePicker();
    savePicker.SuggestedStartLocation = PickerLocationId.DocumentsLibrary;
    // Dropdown of file types the user can save the file as
    savePicker.FileTypeChoices.Add("Plain Text", new List<string>() { ".txt" });
    // Default file name if the user does not type one in or select a file to replace
    savePicker.SuggestedFileName = "New Document";

    StorageFile file = await savePicker.PickSaveFileAsync();
    if (file != null)
    {
        // Prevent updates to the remote version of the file until we finish making changes and call CompleteUpdatesAsync.
        CachedFileManager.DeferUpdates(file);
        // write to file
        await FileIO.WriteTextAsync(file, file.Name);
        // 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.
        FileUpdateStatus status = await CachedFileManager.CompleteUpdatesAsync(file);
        if (status == FileUpdateStatus.Complete)
        {
            OutputTextBlock.Text = "File " + file.Name + " was saved.";
        }
        else
        {
            OutputTextBlock.Text = "File " + file.Name + " couldn't be saved.";
        }
    }
    else
    {
        OutputTextBlock.Text = "Operation cancelled.";
    }
}

설명

중요

PickSaveFileAsync 메서드를 호출하기 전에 속성을 사용하여 FileTypeChoices property 하나 이상의 파일 형식을 지정해야 합니다. 그렇지 않으면 선택기가 예외를 throw합니다.

파일 선택기를 통해 파일을 저장하는 방법을 알아보려면 파일 선택기를 통해 파일을 저장하는 방법을 참조하세요.

파일 및 폴더 파일 선택기 액세스를 시작하려면 파일, 폴더 및 라이브러리를 참조하세요 .

경고

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

버전 기록

Windows 버전 SDK 버전 추가된 값
1903 18362 CreateForUser
1903 18362 사용자

생성자

FileSavePicker()

의 새 인스턴스를 FileSavePicker만듭니다.

데스크톱 앱에서 UI를 표시하는 방식으로 이 클래스의 인스턴스를 사용하기 전에 개체를 소유자의 창 핸들과 연결해야 합니다. 자세한 정보 및 코드 예제는 CoreWindow에 의존하는 WinRT UI 개체 표시를 참조하세요.

속성

CommitButtonText

파일 선택기 UI에서 커밋 단추의 레이블 텍스트를 가져오거나 설정합니다.
ContinuationData

앱이 활성화될 때 컨텍스트를 제공하기 위해 앱을 비활성화하는 작업 전에 PickSaveFileAndContinue 앱에서 채울 값 집합을 가져옵니다. (Windows Phone 8.x 앱)
DefaultFileExtension

이 속성을 사용하지 마세요. 대신 사용합니다 FileTypeChoices property . 저장할 파일에 제공하는 기본 파일 이름 확장명을 fileSavePicker 가져오거나 설정합니다.
EnterpriseId

파일을 소유하는 엔터프라이즈를 지정하는 ID를 가져오거나 설정합니다.
FileTypeChoices

사용자가 파일에 할당하도록 선택할 수 있는 유효한 파일 형식의 컬렉션을 가져옵니다.
SettingsIdentifier

현재 FileSavePicker 인스턴스와 연결된 설정 식별자를 가져오거나 설정합니다.
SuggestedFileName

파일 저장 선택기가 사용자에게 제안하는 파일 이름을 가져오거나 설정합니다.
SuggestedSaveFile

파일 선택기가 파일 저장을 위해 사용자에게 제안하는 파일을 가져오거나 설정합니다 storageFile .
SuggestedStartLocation

파일 저장 선택기가 사용자에게 파일을 저장할 위치로 제안하는 위치를 가져오거나 설정합니다.
User

만들어진 사용자에 대한 FileSavePicker 정보를 가져옵니다. 다중 사용자 애플리케이션에 이 속성을 사용합니다.

메서드

CreateForUser(User)

FileSavePicker 지정된 사용자의 개인 디렉터리로 범위가 지정된 해당 디렉터리를 만듭니다. 다중 사용자 애플리케이션에 이 메서드를 사용합니다.
PickSaveFileAndContinue()

Windows 10 현재 사용되지 않습니다. 대신 사용합니다PickSaveFileAsync. 사용자가 파일을 저장하고, 비활성화하고, 앱을 비활성화하고, 작업이 완료되면 다시 활성화할 수 있도록 파일 선택기를 표시합니다. (Windows Phone 8.x 앱)
PickSaveFileAsync()

사용자가 파일을 저장하고 저장할 파일 이름, 확장명 및 위치를 설정할 수 있도록 파일 선택기를 표시합니다. (UWP 앱)

적용 대상

추가 정보