OpenFileDialog Classe
Definizione
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 che chiede all'utente di aprire un file. La classe non può essere ereditata.
public ref class OpenFileDialog sealed : System::Windows::Forms::FileDialogpublic sealed class OpenFileDialog : System.Windows.Forms.FileDialogtype OpenFileDialog = class
inherit FileDialogPublic NotInheritable Class OpenFileDialog
Inherits FileDialog- Ereditarietà
Esempio
Nell'esempio di codice seguente viene creato un OpenFileDialogoggetto , vengono impostate diverse proprietà per definire il filtro dell'estensione di 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 della finestra di dialogo, Apri e Annulla . Se la proprietà non è impostata su RightToLeft.Yes, viene utilizzato invece testo in inglese.
Se si vuole concedere all'utente la possibilità di selezionare una cartella anziché un file, usare FolderBrowserDialog invece .
Costruttori
| OpenFileDialog() |
Inizializza un'istanza della classe OpenFileDialog. |
Proprietà
| AddExtension |
Ottiene o imposta un valore che indica se la finestra di dialogo aggiunge automaticamente un'estensione a un nome di file quando l'utente non la specifica. (Ereditato da FileDialog) |
| AddToRecent |
Ottiene o imposta un valore che indica se la finestra di dialogo aggiunge il file aperto o salvato all'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 quando l'utente specifica un nome di file inesistente. |
| CheckPathExists |
Ottiene o imposta un valore che indica se nella finestra di dialogo viene visualizzato un avviso quando l'utente specifica un percorso inesistente. (Ereditato da FileDialog) |
| ClientGuid |
Ottiene o imposta il GUID da associare a questo stato del dialogo. In genere, gli stati come l'ultima cartella visitata e la posizione e le dimensioni della finestra di dialogo vengono mantenuti in base al nome del file eseguibile. Specificando un GUID, un'applicazione può avere stati permanenti 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 visivi o se AutoUpgradeEnabled è impostato su |
| Container |
Ottiene l'oggetto IContainer che contiene Component. (Ereditato da Component) |
| CustomPlaces |
Ottiene l’insieme delle posizioni personalizzate per questa istanza di FileDialog. (Ereditato da FileDialog) |
| DefaultExt |
Ottiene o imposta l'estensione di file predefinita. (Ereditato da FileDialog) |
| DereferenceLinks |
Ottiene o imposta un valore che indica se la finestra di dialogo restituisce il percorso del file cui fa riferimento il collegamento o se restituisce la posizione del collegamento (LNK). (Ereditato da FileDialog) |
| DesignMode |
Ottiene un valore che indica se il Component si trova in modalità progettazione. (Ereditato da Component) |
| Events |
Ottiene l'elenco dei gestori eventi allegati a questo Component. (Ereditato da Component) |
| FileName |
Ottiene o imposta una stringa che contiene il nome del file selezionato nella finestra di dialogo per la gestione dei file. (Ereditato da FileDialog) |
| FileNames |
Ottiene i nomi di tutti i file selezionati nella finestra di dialogo. (Ereditato da FileDialog) |
| Filter |
Ottiene o imposta la stringa filtro del nome file corrente, che determina le scelte visualizzate nelle casella relative al tipo di file nella finestra di dialogo. (Ereditato da FileDialog) |
| FilterIndex |
Ottiene o imposta l'indice del filtro attualmente selezionato nella finestra di dialogo per la gestione dei file. (Ereditato da FileDialog) |
| InitialDirectory |
Ottiene o imposta la directory iniziale visualizzata dalla finestra di dialogo per la gestione dei file. (Ereditato da FileDialog) |
| Instance |
Ottiene il punto di controllo dell'istanza Win32 per l'applicazione. (Ereditato da FileDialog) |
| Multiselect |
Ottiene o imposta un valore che indica se la finestra di dialogo consente la selezione multipla di 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 l'inizializzazione dell'oggetto FileDialog. (Ereditato da FileDialog) |
| ReadOnlyChecked |
Ottiene o imposta un valore che indica se è selezionata la casella di controllo di sola lettura. |
| RestoreDirectory |
Ottiene o imposta un valore che indica se la finestra di dialogo ripristina la directory precedentemente selezionata prima della chiusura. (Ereditato da FileDialog) |
| SafeFileName |
Ottiene il nome e l'estensione del file selezionato nella finestra di dialogo. Il nome file non include il percorso. |
| SafeFileNames |
Ottiene una matrice di nomi e di estensioni per tutti i file selezionati nella finestra di dialogo. I nomi dei 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 nella finestra di dialogo per la gestione dei file viene visualizzato il pulsante ?. (Ereditato da FileDialog) |
| ShowHiddenFiles |
Ottiene o imposta un valore che indica se la finestra di dialogo visualizza i file nascosti e di sistema. (Ereditato da FileDialog) |
| ShowPinnedPlaces |
Ottiene o imposta un valore che indica se vengono visualizzati gli elementi visualizzati per impostazione predefinita nel riquadro di spostamento della visualizzazione. (Ereditato da FileDialog) |
| ShowPreview |
Ottiene o imposta un valore che indica se la finestra di dialogo mostra 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 di 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. (Ereditato da FileDialog) |
| Tag |
Ottiene o imposta un oggetto che contiene i dati relativi al controllo. (Ereditato da CommonDialog) |
| Title |
Ottiene o imposta il titolo della finestra di dialogo per la gestione dei file. (Ereditato da FileDialog) |
| ValidateNames |
Ottiene o imposta un valore che indica se la finestra di dialogo accetta soltanto nomi file Win32 validi. (Ereditato da FileDialog) |
Metodi
| CreateObjRef(Type) |
Consente di creare un oggetto che contiene tutte le informazioni rilevanti necessarie per la generazione del proxy utilizzato per effettuare la comunicazione 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, 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.
Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza. (Ereditato da MarshalByRefObject) |
| GetService(Type) |
Consente di restituire un oggetto che rappresenta un servizio fornito da Component o dal relativo Container. (Ereditato da Component) |
| GetType() |
Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object) |
| HookProc(IntPtr, Int32, IntPtr, IntPtr) |
Definisce la routine di hook della finestra di dialogo comune di cui viene eseguito l'override per aggiungere funzionalità specifiche a una finestra di dialogo per la gestione dei 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 dell'oggetto Object corrente. (Ereditato da Object) |
| MemberwiseClone(Boolean) |
Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente. (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 è specificato dalla proprietà FileName. |
| OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr) |
Definisce la routine della finestra proprietaria di cui viene eseguito l'override per aggiungere funzionalità specifiche a una finestra di dialogo comune. (Ereditato da CommonDialog) |
| Reset() |
Reimposta tutte le proprietà sui valori predefiniti. |
| 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 in formato stringa dell'oggetto. (Ereditato da FileDialog) |
Eventi
| Disposed |
Si verifica quando il componente viene eliminato da una chiamata al metodo Dispose(). (Ereditato da Component) |
| FileOk |
Si verifica quando l'utente fa clic sul pulsante Apri o Salva in una finestra di dialogo per la gestione dei file. (Ereditato da FileDialog) |
| HelpRequest |
Si verifica quando l'utente fa clic sul pulsante della Guida in una finestra di dialogo comune. (Ereditato da CommonDialog) |
