FileSavePicker.FileTypeChoices 속성

정의

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

public:
 property IMap<Platform::String ^, IVector<Platform::String ^> ^> ^ FileTypeChoices { IMap<Platform::String ^, IVector<Platform::String ^> ^> ^ get(); };
IMap<winrt::hstring, IVector<winrt::hstring> const&> FileTypeChoices();
public IDictionary<string,IList<string>> FileTypeChoices { get; }
var iMap = fileSavePicker.fileTypeChoices;
Public ReadOnly Property FileTypeChoices As IDictionary(Of String, IList(Of String))

속성 값

IMap<String,IVector<String>>

IDictionary<String,IList<String>>

FilePickerFileTypesOrderedMap 사용자가 파일을 저장하는 데 사용할 수 있는 유효한 파일 형식(확장명) 컬렉션이 들어 있는 개체입니다. 이 컬렉션의 각 요소는 파일 이름 확장명의 해당 컬렉션에 표시 이름을 매핑합니다. 키는 단일 문자열이고, 값은 하나 이상의 확장 선택 항목을 나타내는 문자열의 목록/벡터입니다.

예제

파일 선택기 샘플에서는 표시 이름을 사용하여 파일 형식 선택 항목을 추가하는 방법을 보여 줍니다.

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";
auto plainTextExtensions{ winrt::single_threaded_vector<winrt::hstring>() };
plainTextExtensions.Append(L".txt");

savePicker.FileTypeChoices().Insert(L"Plain Text", plainTextExtensions);
savePicker.SuggestedFileName(L"New Document");

설명

일부 앱은 클라우드 스토리지 공급자와 같이 파일 형식을 처리하기 위해 이해할 필요가 없습니다. 따라서 파일 와일드카드 문자 "*"를 사용하여 컬렉션에 FileOpenPicker.FileTypeFilter 대해 지원됩니다. 그러나 파일을 작성하려면 해당 형식에 대한 지식이 필요합니다. 따라서 FileSavePicker.FileTypeChoices에 대해 와일드카드가 지원되지 않습니다.

파일 형식의 분류로서 하나의 표시 이름에는 이를 지원하는 여러 파일 형식이 있을 수 있습니다. 예를 들어 "HTML 페이지"의 표시 이름은 ".htm" 또는 ".html" 확장으로 저장할 수 있습니다. 따라서 각 항목의 값은 벡터에 FilePickerFileTypesOrderedMap 확장을 배치하는 순서대로 UI에 표시되는 문자열의 순서가 지정된 목록(벡터)입니다.

적용 대상

추가 정보