FileSavePickerUI 클래스

정의

네임스페이스:

Windows.Storage.Pickers.Provider

앱이 파일 저장 선택기 계약을 사용하여 저장 위치를 제공하는 경우 파일 선택기와 상호 작용하는 데 사용됩니다.

public ref class FileSavePickerUI sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class FileSavePickerUI final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class FileSavePickerUI

Public NotInheritable Class FileSavePickerUI

상속

Object Platform::Object IInspectable FileSavePickerUI

특성

ContractVersionAttribute

Windows 요구 사항

디바이스 패밀리	Windows 10 (10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)

예제

파일 선택기 샘플에서는 FileSavePicker 활성화 이벤트에 응답하는 방법을 보여 줍니다.

// fileSavePicker activated event handler
protected override void OnFileSavePickerActivated(FileSavePickerActivatedEventArgs args)
{
    var FileSavePickerPage = new SDKTemplate.FileSavePickerPage();
    FileSavePickerPage.Activate(args);
}

// Overloaded method to respond to fileSavePicker events
internal void Activate(FileSavePickerActivatedEventArgs args)
{
    // Perform tasks to prepare your app to display its file picker page

    // Get file picker UI
    fileSavePickerUI = args.FileSavePickerUI;

    Window.Current.Content = this;
    this.OnNavigatedTo(null);
    Window.Current.Activate();
}

C# args 의 경우 FileSavePickerActivatedEventArgs 개체를 포함합니다. 또한 는 OnFileSavePickerActivated App.xaml.cs 파일에 있고 Activate 메서드는 파일 선택기 샘플의 FileSavePickerPage.xaml.cs 파일에 있습니다.

설명

앱이 파일 저장 선택기 계약에 참여하는 경우 FileSavePicker 활성화 이벤트를 처리하는 동안 fileSavePickerUI 속성을 사용하여 이 개체에 액세스할 수 있습니다.

FileSavePickerActivatedEventArgs.FileSavePickerUI 속성을 사용하여 fileSavePickerUI 개체를 검색합니다.

사용자가 앱을 저장 위치로 사용할 때 좋은 환경을 만드는 방법에 대한 자세한 내용은 선택기로 파일 및 폴더 열기를 참조하세요.

속성

AllowedFileTypes	저장 위치를 제공하는 앱에 저장할 수 있는 파일 형식(확장명) 목록을 가져옵니다.
FileName	파일 형식 확장명을 포함하여 저장할 파일의 전체 파일 이름을 가져옵니다. 파일 이름 및 확장명은 사용자가 지정합니다.
SettingsIdentifier	파일 선택기의 현재 컨텍스트에 대한 식별자를 가져옵니다.
Title	파일 선택기가 사용자에게 표시하는 위치를 식별하는 파일 선택기 UI에 표시할 제목을 가져오거나 설정합니다.

메서드

TrySetFileName(String)

파일 선택기 UI에서 파일 이름 및 확장명을 설정하려고 시도합니다.

이벤트

FileNameChanged	사용자가 파일 이름 텍스트 상자에서 파일 이름을 변경하거나 파일 형식 드롭다운 메뉴의 확장명을 변경할 때 발생합니다.
TargetFileRequested	사용자가 파일을 커밋하여 파일 선택기에서 저장할 때 발생합니다.

추가 정보

• ActivationKind
• FileSavePickerUI
• FileSavePickerUI
• 선택기를 사용하여 파일 및 폴더 열기
• 파일 선택기 계약 샘플