FileSavePickerUI Klasse

Referenz

Definition

Namespace:: Windows.Storage.Pickers.Provider

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Wird verwendet, um mit der Dateiauswahl zu interagieren, wenn Ihre App einen Speicherort mit dem Vertrag Dateispeicherauswahl bereitstellt.

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

Vererbung: Object Platform::Object IInspectable FileSavePickerUI

Attribute: ContractVersionAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

Das Beispiel für die Dateiauswahl veranschaulicht, wie auf ein aktiviertes FileSavePicker-Ereignis reagiert wird.

// 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();
}

Enthält für C# args ein FileSavePickerActivatedEventArgs-Objekt . Darüber hinaus befindet sich der OnFileSavePickerActivated in der Datei App.xaml.cs und die Activate -Methode in der Datei FileSavePickerPage.xaml.cs des Dateiauswahlbeispiels.

Hinweise

Wenn Ihre App am Vertrag Dateispeicherauswahl teilnimmt, können Sie mithilfe einer fileSavePickerUI-Eigenschaft auf dieses Objekt zugreifen, während Sie ein aktiviertes FileSavePicker-Ereignis behandeln.

Verwenden Sie die FileSavePickerActivatedEventArgs.FileSavePickerUI-Eigenschaft , um ein fileSavePickerUI-Objekt abzurufen.

Informationen zum Erstellen einer guten Benutzeroberfläche für Benutzer, wenn sie Ihre App als Speicherort verwenden, finden Sie unter Öffnen von Dateien und Ordnern mit einer Auswahl.

Eigenschaften

AllowedFileTypes	Ruft eine Liste der Dateitypen (Erweiterungen) ab, die in der App gespeichert werden können, die den Speicherort bereitstellt.
FileName	Ruft den vollständigen Dateinamen der zu speichernden Datei ab, einschließlich der Dateityperweiterung. Der Dateiname und die Erweiterung werden vom Benutzer angegeben.
SettingsIdentifier	Ruft einen Bezeichner für den aktuellen Kontext der Dateiauswahl ab.
Title	Ruft einen Titel ab, der auf der Dateiauswahl-Benutzeroberfläche angezeigt werden soll, der den Speicherort identifiziert, den die Dateiauswahl dem Benutzer anzeigt, oder legt diesen fest.

Methoden

TrySetFileName(String)

Versucht, den Dateinamen und die Erweiterung in der Benutzeroberfläche der Dateiauswahl festzulegen.

Ereignisse

FileNameChanged	Wird ausgelöst, wenn der Benutzer den Dateinamen im Textfeld Dateiname ändert oder die Erweiterung im Dropdownmenü Dateityp ändert.
TargetFileRequested	Wird ausgelöst, wenn der Benutzer eine Datei committet, die in der Dateiauswahl gespeichert werden soll.

Gilt für:

Freigeben über