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 uno o più file da aprire.

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
FileDialog
OpenFileDialog
Ereditarietà
Object
CommonDialog
CommonItemDialog
FileDialog
OpenFileDialog

Esempio

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

// 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.Value)
{
    // 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

Nome Descrizione
OpenFileDialog()

Inizializza una nuova istanza della classe OpenFileDialog.

Proprietà

Nome Descrizione
AddExtension

Ottiene o imposta un valore che indica se una finestra di dialogo di file aggiunge automaticamente un'estensione a un nome file se l'utente omette un'estensione.

(Ereditato da FileDialog)
AddToRecent

Ottiene o imposta un valore che indica se la finestra di dialogo aggiungerà l'elemento da aprire o salvare nell'elenco di documenti recenti.

(Ereditato da CommonItemDialog)
CheckFileExists

Ottiene o imposta un valore che indica se una finestra di dialogo di file visualizza un avviso se l'utente specifica un nome di file che non esiste.

(Ereditato da FileDialog)
CheckPathExists

Ottiene o imposta un valore che specifica se gli avvisi vengono visualizzati se l'utente digita percorsi e nomi di 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 per le 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 di estensione predefinita da utilizzare per filtrare l'elenco di file visualizzati.

(Ereditato da FileDialog)
DereferenceLinks

Ottiene o imposta un valore che indica se una finestra di dialogo di file restituisce il percorso del file a cui fa riferimento un collegamento o il percorso del file di collegamento (.lnk).

(Ereditato da FileDialog)
FileName

Ottiene o imposta una stringa contenente il percorso completo del file selezionato in una finestra di dialogo di file.

(Ereditato da FileDialog)
FileNames

Ottiene una matrice che contiene un nome di 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 di 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 di 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 di file comuni Win32 utilizzati dalle finestre di dialogo 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 da OpenFileDialog è selezionata.
RestoreDirectory

Questa proprietà non è implementata.

(Ereditato da FileDialog)
RootDirectory

Ottiene o imposta la directory visualizzata come radice di navigazione per la finestra di dialogo.

(Ereditato da CommonItemDialog)
SafeFileName

Ottiene una stringa che contiene solo il nome file per il file selezionato.

(Ereditato da FileDialog)
SafeFileNames

Ottiene una matrice contenente un nome di file sicuro per ogni file selezionato.

(Ereditato da FileDialog)
ShowHiddenItems

Ottiene o imposta un valore che indica se la finestra di dialogo mostrerà elementi nascosti e di sistema indipendentemente dalle preferenze dell'utente.

(Ereditato da CommonItemDialog)
ShowReadOnly

Ottiene o imposta un valore che indica se OpenFileDialog contiene una casella di controllo di sola lettura.
Tag

Ottiene o imposta un oggetto associato alla finestra di dialogo. In questo modo è possibile associare un oggetto arbitrario al dialogo.

(Ereditato da CommonDialog)
Title

Ottiene o imposta il testo visualizzato nella barra del titolo di una finestra di dialogo di 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

Nome Descrizione
CheckPermissionsToShowDialog()

Determina se esistono 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 il Type dell'istanza corrente.

(Ereditato da Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)

Definisce la procedura di hook della finestra di dialogo di file comune sottoposta a override per aggiungere funzionalità comuni a una finestra di dialogo di file.

(Ereditato da FileDialog)
MemberwiseClone()

Crea una copia superficiale del Objectcorrente.

(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 tramite OpenFileDialog.
OpenFiles()

Crea una matrice che contiene un flusso di sola lettura per ogni file selezionato dall'utente usando OpenFileDialog.
Reset()

Reimposta tutti i valori predefiniti di tutte le OpenFileDialog proprietà.
RunDialog(IntPtr)

RunDialog(IntPtr) viene chiamato per visualizzare una finestra di dialogo di file in una classe derivata, ad esempio OpenFileDialog e SaveFileDialog.

(Ereditato da FileDialog)
ShowDialog()

Visualizza una finestra di dialogo comune.

(Ereditato da CommonDialog)
ShowDialog(Window)

Visualizza una finestra di dialogo comune.

(Ereditato da CommonDialog)
ToString()

Restituisce una stringa che rappresenta una finestra di dialogo di file.

(Ereditato da FileDialog)

Eventi

Nome Descrizione
FileOk

Si verifica quando l'utente seleziona un nome di file facendo clic sul pulsante Apri del OpenFileDialog o sul pulsante Salva di SaveFileDialog.

(Ereditato da FileDialog)

Si applica a

Vedi anche