OpenFileDialog.OpenFile-Methode

Artikel
08/20/2007

Öffnet die vom Benutzer ausgewählte Datei schreibgeschützt. Die Datei wird durch die FileName-Eigenschaft angegeben.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public Function OpenFile As Stream
'Usage
Dim instance As OpenFileDialog
Dim returnValue As Stream

returnValue = instance.OpenFile

public Stream OpenFile ()

public:
Stream^ OpenFile ()

public Stream OpenFile ()

public function OpenFile () : Stream

Rückgabewert

Ein Stream, durch den die vom Benutzer ausgewählte schreibgeschützte Datei angegeben wird.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentNullException	Der Dateiname lautet NULL (Nothing in Visual Basic).

Hinweise

Die OpenFile-Methode stellt eine Möglichkeit bereit, eine Datei schnell aus dem Dialogfeld zu öffnen. Die Datei wird aus Sicherheitsgründen im schreibgeschützten Modus geöffnet. Zum Öffnen einer Datei im Lese-/Schreibmodus müssen Sie eine andere Methode verwenden, z. B. FileStream.

Beispiel

Im folgenden Codebeispiel wird die Verwendung der OpenFile-Methode veranschaulicht. In diesem Beispiel wird ein OpenFileDialog angezeigt, wobei die ShowReadOnly-Eigenschaft auf true festgelegt ist. Wenn der Benutzer auf die Option klickt, mit der die Datei im schreibgeschützten Modus geöffnet wird, wird die OpenFile-Methode verwendet, um die Datei zu öffnen. Andernfalls wird die FileStream-Klasse verwendet, um die Datei im schreibgeschützten Modus zu öffnen.

Private Function OpenFile() As FileStream

    ' Displays an OpenFileDialog and shows the read/only files.

    Dim DlgOpenFile As New OpenFileDialog()
    DlgOpenFile.ShowReadOnly = True
    Dim Fs As FileStream

    If DlgOpenFile.ShowDialog() = DialogResult.OK Then

        ' If ReadOnlyChecked is true, uses the OpenFile method to
        ' open the file with read/only access.

        If DlgOpenFile.ReadOnlyChecked = True Then

            Return DlgOpenFile.OpenFile()

            ' Otherwise, opens the file with read/write access.

        Else

            Dim Path As String = DlgOpenFile.FileName
            Return New FileStream(Path, System.IO.FileMode.Open, _
                    System.IO.FileAccess.ReadWrite)


        End If

    End If


End Function

private FileStream OpenFile()
{
    // Displays an OpenFileDialog and shows the read/only files.

    OpenFileDialog dlgOpenFile = new OpenFileDialog();
    dlgOpenFile.ShowReadOnly = true;


    if(dlgOpenFile.ShowDialog() == DialogResult.OK)
    {

        // If ReadOnlyChecked is true, uses the OpenFile method to
        // open the file with read/only access.

        if(dlgOpenFile.ReadOnlyChecked == true)
        {
            return (FileStream)dlgOpenFile.OpenFile();

        }

        // Otherwise, opens the file with read/write access.

        else
        {
            string path = dlgOpenFile.FileName;
            return new FileStream(path, System.IO.FileMode.Open, 
                    System.IO.FileAccess.ReadWrite);
        }


    }

    return null;


}

private:
   FileStream^ OpenFile()
   {
      // Displays an OpenFileDialog and shows the read/only files.
      OpenFileDialog^ dlgOpenFile = gcnew OpenFileDialog;
      dlgOpenFile->ShowReadOnly = true;
      if ( dlgOpenFile->ShowDialog() == ::DialogResult::OK )
      {
         // If ReadOnlyChecked is true, uses the OpenFile method to
         // open the file with read/only access.
         if ( dlgOpenFile->ReadOnlyChecked == true )
         {
            return dynamic_cast<FileStream^>(dlgOpenFile->OpenFile());
         }
         // Otherwise, opens the file with read/write access.
         else
         {
            String^ path = dlgOpenFile->FileName;
            return gcnew FileStream( path,System::IO::FileMode::Open,System::IO::FileAccess::ReadWrite );
         }
      }

      return nullptr;
   }

private FileStream OpenFile()
{
    // Displays an OpenFileDialog and shows the read/only files.
    OpenFileDialog dlgOpenFile = new OpenFileDialog();
    dlgOpenFile.set_ShowReadOnly(true);
    if (dlgOpenFile.ShowDialog().Equals(get_DialogResult().OK)) {
        // If ReadOnlyChecked is true, uses the OpenFile method to
        // open the file with read/only access.
        if (dlgOpenFile.get_ReadOnlyChecked() == true) {
            return (FileStream)dlgOpenFile.OpenFile();
        }
        // Otherwise, opens the file with read/write access.
        else {
            String path = dlgOpenFile.get_FileName();
            return new FileStream(path, System.IO.FileMode.Open,
                System.IO.FileAccess.ReadWrite);
        }
    }
    return null;
} //OpenFile

.NET Framework-Sicherheit

FileDialogPermission zum Öffnen einer Datei. Zugeordnete Enumeration: FileDialogPermissionAccess.Open

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

OpenFileDialog-Klasse
OpenFileDialog-Member
System.Windows.Forms-Namespace
Stream
CheckFileExists
ReadOnlyChecked

Freigeben über