OpenFileDialog Classe

Definizione

Spazio dei nomi:

Microsoft.Win32

Assembly:

PresentationFramework.dll

Rappresenta una finestra di dialogo comune che consente a un utente di specificare un nome file per aprire uno o più file.

public ref class OpenFileDialog sealed : Microsoft::Win32::FileDialog

public sealed class OpenFileDialog : Microsoft.Win32.FileDialog

type OpenFileDialog = class
    inherit FileDialog

Public NotInheritable Class OpenFileDialog
Inherits FileDialog

Ereditarietà

Object

CommonDialog

CommonItemDialog

FileDialog

OpenFileDialog

Esempio

Nell'esempio seguente viene illustrato come creare un oggetto OpenFileDialog contenente un nome file predefinito e un tipo di estensione.

// Configure open file dialog box
Microsoft.Win32.OpenFileDialog dlg = new Microsoft.Win32.OpenFileDialog();
dlg.FileName = "Document"; // Default file name
dlg.DefaultExt = ".txt"; // Default file extension
dlg.Filter = "Text documents (.txt)|*.txt"; // Filter files by extension

// Show open file dialog box
Nullable<bool> result = dlg.ShowDialog();

// Process open file dialog box results
if (result == true)
{
    // Open document
    string filename = dlg.FileName;
}

' Configure open file dialog box
Dim dlg As New Microsoft.Win32.OpenFileDialog()
dlg.FileName = "Document" ' Default file name
dlg.DefaultExt = ".txt" ' Default file extension
dlg.Filter = "Text documents (.txt)|*.txt" ' Filter files by extension

' Show open file dialog box
Dim result? As Boolean = dlg.ShowDialog()

' Process open file dialog box results
If result = True Then
    ' Open document
    Dim filename As String = dlg.FileName
End If

Commenti

Non è possibile dichiarare questa classe gestita in XAML.

Costruttori

OpenFileDialog()

Inizializza una nuova istanza della classe OpenFileDialog.

Proprietà

AddExtension	Ottiene o imposta un valore che indica se un'estensione viene automaticamente aggiunta a un nome file da parte della finestra di dialogo file quando l'utente non la specifica. (Ereditato da FileDialog)
AddToRecent	Ottiene o imposta un valore che indica se la finestra di dialogo aggiungerà l'elemento aperto o salvato nell'elenco dei documenti recenti. (Ereditato da CommonItemDialog)
CheckFileExists	Ottiene o imposta un valore che indica se nella finestra di dialogo file viene visualizzato un avviso quando l'utente specifica un nome file inesistente. (Ereditato da FileDialog)
CheckPathExists	Ottiene o imposta un valore che specifica se vengono visualizzati avvisi quando l'utente digita percorsi e nomi file non validi. (Ereditato da FileDialog)
ClientGuid	Ottiene o imposta un GUID da associare allo stato persistente del dialogo. (Ereditato da CommonItemDialog)
CustomPlaces	Ottiene o imposta l'elenco di posizioni personalizzate delle finestre di dialogo dei file. (Ereditato da FileDialog)
DefaultDirectory	Ottiene o imposta la directory visualizzata dalla finestra di dialogo file se non è disponibile alcun valore di directory usato di recente. (Ereditato da CommonItemDialog)
DefaultExt	Ottiene o imposta un valore che specifica la stringa dell'estensione predefinita da usare per filtrare l'elenco di file visualizzati. (Ereditato da FileDialog)
DereferenceLinks	Ottiene o imposta un valore che indica se una finestra di dialogo file restituisce il percorso del file a cui fa riferimento il collegamento o il percorso del file del collegamento (lnk). (Ereditato da FileDialog)
FileName	Ottiene o imposta una stringa che contiene il percorso completo del file selezionato in una finestra di dialogo file. (Ereditato da FileDialog)
FileNames	Ottiene una matrice che contiene un nome file per ogni file selezionato. (Ereditato da FileDialog)
Filter	Ottiene o imposta la stringa di filtro che determina i tipi di file visualizzati da OpenFileDialog o SaveFileDialog. (Ereditato da FileDialog)
FilterIndex	Ottiene o imposta l'indice del filtro attualmente selezionato in una finestra di dialogo file. (Ereditato da FileDialog)
ForcePreviewPane	Ottiene o imposta un flag di opzione che indica se la finestra di dialogo forza il riquadro di anteprima.
InitialDirectory	Ottiene o imposta la directory iniziale visualizzata da una finestra di dialogo file. (Ereditato da FileDialog)
Multiselect	Ottiene o imposta un'opzione che indica se OpenFileDialog consente agli utenti di selezionare più file.
Options	Ottiene i flag della finestra di dialogo file comuni Win32 usati dai dialoghi di file per l'inizializzazione. (Ereditato da FileDialog)
ReadOnlyChecked	Ottiene o imposta un valore che indica se la casella di controllo di sola lettura visualizzata nell'oggetto OpenFileDialog è selezionata.
RestoreDirectory	Questa proprietà non è implementata. (Ereditato da FileDialog)
RootDirectory	Ottiene o imposta la directory visualizzata come radice di spostamento per la finestra di dialogo. (Ereditato da CommonItemDialog)
SafeFileName	Ottiene una stringa che contiene solo il nome del file selezionato. (Ereditato da FileDialog)
SafeFileNames	Ottiene una matrice che contiene un nome file sicuro per ogni file selezionato. (Ereditato da FileDialog)
ShowHiddenItems	Ottiene o imposta un valore che indica se la finestra di dialogo visualizzerà elementi nascosti e di sistema indipendentemente dalle preferenze utente. (Ereditato da CommonItemDialog)
ShowReadOnly	Ottiene o imposta un valore che indica se l'oggetto OpenFileDialog contiene una casella di controllo di sola lettura.
Tag	Ottiene o imposta un oggetto associato alla finestra di dialogo. Consente di allegare un oggetto arbitrario alla finestra di dialogo. (Ereditato da CommonDialog)
Title	Ottiene o imposta il testo visualizzato nella barra del titolo di una finestra di dialogo file. (Ereditato da FileDialog)
ValidateNames	Ottiene o imposta un valore che indica se la finestra di dialogo accetta solo nomi di file Win32 validi. (Ereditato da FileDialog)

Metodi

CheckPermissionsToShowDialog()	Determina se sono disponibili autorizzazioni sufficienti per la visualizzazione di una finestra di dialogo. (Ereditato da CommonDialog)
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Definisce la procedura hook della finestra di dialogo file comune di cui viene eseguito l'override per aggiungere funzionalità comuni a una finestra di dialogo file. (Ereditato da FileDialog)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
OnFileOk(CancelEventArgs)	Genera l'evento FileOk. (Ereditato da FileDialog)
OnItemOk(CancelEventArgs)	Genera l'evento FileOk. (Ereditato da FileDialog)
OpenFile()	Apre un flusso di sola lettura per il file selezionato dall'utente utilizzando OpenFileDialog.
OpenFiles()	Crea una matrice che contiene un flusso di sola lettura per ogni file selezionato dall'utente utilizzando OpenFileDialog.
Reset()	Ripristina i valori predefiniti per tutte le proprietà di OpenFileDialog.
RunDialog(IntPtr)	Il metodo RunDialog(IntPtr) viene chiamato per visualizzare una finestra di dialogo file in una classe derivata, ad esempio OpenFileDialog e SaveFileDialog. (Ereditato da FileDialog)
ShowDialog()	Consente di visualizzare una finestra di dialogo comune. (Ereditato da CommonDialog)
ShowDialog(Window)	Consente di visualizzare una finestra di dialogo comune. (Ereditato da CommonDialog)
ToString()	Restituisce una stringa che rappresenta una finestra di dialogo file. (Ereditato da FileDialog)

Eventi

FileOk

Si verifica quando l'utente seleziona un nome file facendo clic sul pulsante Apri dell'oggetto OpenFileDialog o sul pulsante Salva dell'oggetto SaveFileDialog. (Ereditato da FileDialog)

Vedi anche

• SaveFileDialog