OpenFileDialog Classe

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origine:

OpenFileDialog.cs

Visualizza una finestra di dialogo standard che richiede all'utente di aprire un file. Questa classe non può essere ereditata.

public ref class OpenFileDialog sealed : System::Windows::Forms::FileDialog

public sealed class OpenFileDialog : System.Windows.Forms.FileDialog

type OpenFileDialog = class
    inherit FileDialog

Public NotInheritable Class OpenFileDialog
Inherits FileDialog

Ereditarietà

Object

MarshalByRefObject

Component

CommonDialog

FileDialog

OpenFileDialog

Esempio

Nell'esempio di codice seguente viene creato un oggetto OpenFileDialog, vengono impostate diverse proprietà per definire il filtro di estensione file e il comportamento della finestra di dialogo e viene visualizzata la finestra di dialogo usando il CommonDialog.ShowDialog metodo . L'esempio richiede un form con un Button oggetto posizionato su di esso e un riferimento allo System.IO spazio dei nomi aggiunto.

private:
   void button1_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      Stream^ myStream;
      OpenFileDialog^ openFileDialog1 = gcnew OpenFileDialog;

      openFileDialog1->InitialDirectory = "c:\\";
      openFileDialog1->Filter = "txt files (*.txt)|*.txt|All files (*.*)|*.*";
      openFileDialog1->FilterIndex = 2;
      openFileDialog1->RestoreDirectory = true;

      if ( openFileDialog1->ShowDialog() == System::Windows::Forms::DialogResult::OK )
      {
         if ( (myStream = openFileDialog1->OpenFile()) != nullptr )
         {
            // Insert code to read the stream here.
            myStream->Close();
         }
      }
   }

var fileContent = string.Empty;
var filePath = string.Empty;

using (OpenFileDialog openFileDialog = new OpenFileDialog())
{
    openFileDialog.InitialDirectory = "c:\\";
    openFileDialog.Filter = "txt files (*.txt)|*.txt|All files (*.*)|*.*";
    openFileDialog.FilterIndex = 2;
    openFileDialog.RestoreDirectory = true;

    if (openFileDialog.ShowDialog() == DialogResult.OK)
    {
        //Get the path of specified file
        filePath = openFileDialog.FileName;

        //Read the contents of the file into a stream
        var fileStream = openFileDialog.OpenFile();

        using (StreamReader reader = new StreamReader(fileStream))
        {
            fileContent = reader.ReadToEnd();
        }
    }
}

MessageBox.Show(fileContent, "File Content at path: " + filePath, MessageBoxButtons.OK);

Private Sub button1_Click(ByVal sender As Object, ByVal e As System.EventArgs)
    Dim myStream As Stream = Nothing
    Dim openFileDialog1 As New OpenFileDialog()

    openFileDialog1.InitialDirectory = "c:\"
    openFileDialog1.Filter = "txt files (*.txt)|*.txt|All files (*.*)|*.*"
    openFileDialog1.FilterIndex = 2
    openFileDialog1.RestoreDirectory = True

    If openFileDialog1.ShowDialog() = System.Windows.Forms.DialogResult.OK Then
        Try
            myStream = openFileDialog1.OpenFile()
            If (myStream IsNot Nothing) Then
                ' Insert code to read the stream here.
            End If
        Catch Ex As Exception
            MessageBox.Show("Cannot read file from disk. Original error: " & Ex.Message)
        Finally
            ' Check this again, since we need to make sure we didn't throw an exception on open.
            If (myStream IsNot Nothing) Then
                myStream.Close()
            End If
        End Try
    End If
End Sub

Commenti

Questa classe consente di verificare se esiste un file e aprirlo. La ShowReadOnly proprietà determina se nella finestra di dialogo viene visualizzata una casella di controllo di sola lettura. La ReadOnlyChecked proprietà indica se la casella di controllo di sola lettura è selezionata.

La maggior parte delle funzionalità di base per questa classe è disponibile nella FileDialog classe .

In un sistema operativo da destra a sinistra impostare la proprietà del RightToLeft modulo contenitore per RightToLeft.Yes localizzare i pulsanti Nome file, Apri e Annulla della finestra di dialogo. Se la proprietà non è impostata su RightToLeft.Yes, viene invece utilizzato il testo in inglese.

Se si vuole concedere all'utente la possibilità di selezionare una cartella anziché un file, usare FolderBrowserDialog invece .

Costruttori

Nome	Descrizione
OpenFileDialog()	Inizializza un'istanza della OpenFileDialog classe .

Proprietà

Nome	Descrizione
AddExtension	Ottiene o imposta un valore che indica se la finestra di dialogo aggiunge automaticamente un'estensione a un nome file se l'utente omette l'estensione. (Ereditato da FileDialog)
AddToRecent	Ottiene o imposta un valore che indica se la finestra di dialogo aggiunge il file da aprire o salvare nell'elenco recente. (Ereditato da FileDialog)
AutoUpgradeEnabled	Ottiene o imposta un valore che indica se questa FileDialog istanza deve aggiornare automaticamente l'aspetto e il comportamento durante l'esecuzione in Windows Vista. (Ereditato da FileDialog)
CheckFileExists	Ottiene o imposta un valore che indica se nella finestra di dialogo viene visualizzato un avviso se l'utente specifica un nome di file che non esiste.
CheckPathExists	Ottiene o imposta un valore che indica se nella finestra di dialogo viene visualizzato un avviso se l'utente specifica un percorso che non esiste. (Ereditato da FileDialog)
ClientGuid	Ottiene o imposta il GUID da associare a questo stato del dialogo. In genere, lo stato, ad esempio l'ultima cartella visitata e la posizione e le dimensioni del dialogo, vengono mantenuti in base al nome del file eseguibile. Specificando un GUID, un'applicazione può avere stati persistenti diversi per versioni diverse della finestra di dialogo all'interno della stessa applicazione, ad esempio una finestra di dialogo di importazione e una finestra di dialogo aperta. Questa funzionalità non è disponibile se un'applicazione non usa stili di visualizzazione o se AutoUpgradeEnabled è impostata su false. (Ereditato da FileDialog)
CustomPlaces	Ottiene la raccolta di posizioni personalizzate per questa FileDialog istanza. (Ereditato da FileDialog)
DefaultExt	Ottiene o imposta l'estensione del nome file predefinita. (Ereditato da FileDialog)
DereferenceLinks	Ottiene o imposta un valore che indica se la finestra di dialogo restituisce il percorso del file a cui fa riferimento il collegamento o se restituisce il percorso del collegamento (.lnk). (Ereditato da FileDialog)
FileName	Ottiene o imposta una stringa contenente il nome file selezionato nella finestra di dialogo file. (Ereditato da FileDialog)
FileNames	Ottiene i nomi di file di tutti i file selezionati nella finestra di dialogo. (Ereditato da FileDialog)
Filter	Ottiene o imposta la stringa di filtro del nome file corrente, che determina le scelte visualizzate nella casella "Salva come file di tipo" o "File di tipo" nella finestra di dialogo. (Ereditato da FileDialog)
FilterIndex	Ottiene o imposta l'indice del filtro attualmente selezionato nella finestra di dialogo file. (Ereditato da FileDialog)
InitialDirectory	Ottiene o imposta la directory iniziale visualizzata dalla finestra di dialogo file. (Ereditato da FileDialog)
Instance	Ottiene l'handle dell'istanza Win32 per l'applicazione. (Ereditato da FileDialog)
Multiselect	Ottiene o imposta un valore che indica se la finestra di dialogo consente di selezionare più file.
OkRequiresInteraction	Ottiene o imposta un valore che indica se il pulsante OK della finestra di dialogo è disabilitato fino a quando l'utente non naviga nella visualizzazione o modifica il nome file (se applicabile). (Ereditato da FileDialog)
Options	Ottiene i valori per inizializzare l'oggetto FileDialog. (Ereditato da FileDialog)
ReadOnlyChecked	Ottiene o imposta un valore che indica se la casella di controllo di sola lettura è selezionata.
RestoreDirectory	Ottiene o imposta un valore che indica se la finestra di dialogo ripristina la directory nella directory selezionata in precedenza prima della chiusura. (Ereditato da FileDialog)
SafeFileName	Ottiene il nome file e l'estensione per il file selezionato nella finestra di dialogo. Il nome del file non include il percorso.
SafeFileNames	Ottiene una matrice di nomi di file ed estensioni per tutti i file selezionati nella finestra di dialogo. I nomi di file non includono il percorso.
SelectReadOnly	Ottiene o imposta un valore che indica se la finestra di dialogo consente la selezione di file di sola lettura.
ShowHelp	Ottiene o imposta un valore che indica se il pulsante ? viene visualizzato nella finestra di dialogo file. (Ereditato da FileDialog)
ShowHiddenFiles	Ottiene o imposta un valore che indica se nella finestra di dialogo vengono visualizzati file nascosti e di sistema. (Ereditato da FileDialog)
ShowPinnedPlaces	Ottiene o imposta un valore che indica se gli elementi visualizzati per impostazione predefinita nel riquadro di spostamento della visualizzazione vengono visualizzati. (Ereditato da FileDialog)
ShowPreview	Ottiene o imposta un valore che indica se nella finestra di dialogo viene visualizzata un'anteprima per i file selezionati.
ShowReadOnly	Ottiene o imposta un valore che indica se la finestra di dialogo contiene una casella di controllo di sola lettura.
SupportMultiDottedExtensions	Ottiene o imposta un valore che indica se la finestra di dialogo supporta la visualizzazione e il salvataggio di file con più estensioni di file. (Ereditato da FileDialog)
Tag	Ottiene o imposta un oggetto che contiene dati sul controllo. (Ereditato da CommonDialog)
Title	Ottiene o imposta il titolo della finestra di dialogo del 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
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Definisce la routine hook della finestra di dialogo comune sottoposta a override per aggiungere funzionalità specifiche alla finestra di dialogo file. (Ereditato da FileDialog)
OnFileOk(CancelEventArgs)	Genera l'evento FileOk. (Ereditato da FileDialog)
OnHelpRequest(EventArgs)	Genera l'evento HelpRequest. (Ereditato da CommonDialog)
OpenFile()	Apre il file selezionato dall'utente, con autorizzazione di sola lettura. Il file viene specificato dalla FileName proprietà .
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)	Definisce la routine della finestra di proprietario sottoposta a override per aggiungere funzionalità specifiche a una finestra di dialogo comune. (Ereditato da CommonDialog)
Reset()	Reimposta tutti i valori predefiniti di tutte le proprietà.
RunDialog(IntPtr)	Specifica una finestra di dialogo comune. (Ereditato da FileDialog)
ShowDialog()	Esegue una finestra di dialogo comune con un proprietario predefinito. (Ereditato da CommonDialog)
ShowDialog(IWin32Window)	Esegue una finestra di dialogo comune con il proprietario specificato. (Ereditato da CommonDialog)
ToString()	Fornisce una versione stringa di questo oggetto. (Ereditato da FileDialog)

Eventi

Nome	Descrizione
FileOk	Si verifica quando l'utente fa clic sul pulsante Apri o Salva in una finestra di dialogo file. (Ereditato da FileDialog)
HelpRequest	Si verifica quando l'utente fa clic sul pulsante ? in una finestra di dialogo comune. (Ereditato da CommonDialog)

Vedi anche

• FileDialog
• CommonDialog
• SaveFileDialog
• Procedura: Leggere testo da un file