OpenFileDialog Classe

Definizione

Spazio dei nomi:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Origine:: OpenFileDialog.cs

Origine:: OpenFileDialog.cs

Origine:: OpenFileDialog.cs

Origine:: OpenFileDialog.cs

Origine:: OpenFileDialog.cs

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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)
CanRaiseEvents	Ottiene un valore che indica se il componente può generare un evento. (Ereditato da Component)
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)
Container	Ottiene l'oggetto IContainer contenente l'oggetto Component. (Ereditato da Component)
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)
DesignMode	Ottiene un valore che indica se è Component attualmente in modalità progettazione. (Ereditato da Component)
Events	Ottiene l'elenco dei gestori eventi associati a questo Componentoggetto . (Ereditato da Component)
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.
Site	Ottiene o imposta l'oggetto ISite dell'oggetto Component. (Ereditato da Component)
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
CreateObjRef(Type)	Crea un oggetto che contiene tutte le informazioni pertinenti necessarie per generare un proxy utilizzato per comunicare con un oggetto remoto. (Ereditato da MarshalByRefObject)
Dispose()	Rilascia tutte le risorse usate da Component. (Ereditato da Component)
Dispose(Boolean)	Rilascia le risorse non gestite usate da Component e, facoltativamente, rilascia le risorse gestite. (Ereditato da Component)
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetLifetimeService()	Obsoleti. Recupera l'oggetto servizio di durata corrente che controlla i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject)
GetService(Type)	Restituisce un oggetto che rappresenta un servizio fornito da Component o da Container. (Ereditato da Component)
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
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)
InitializeLifetimeService()	Obsoleti. Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject)
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
MemberwiseClone(Boolean)	Crea una copia superficiale dell'oggetto corrente MarshalByRefObject . (Ereditato da MarshalByRefObject)
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
Disposed	Si verifica quando il componente viene eliminato da una chiamata al Dispose() metodo . (Ereditato da Component)
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)

Si applica a

Vedi anche

Commenti e suggerimenti

Questa pagina è stata utile?