File.Open Metoda

Reference

Definice

Obor názvů:: System.IO

Sestavení:: mscorlib.dll, System.IO.FileSystem.dll

Sestavení:: System.IO.FileSystem.dll

Sestavení:: System.Runtime.dll

Sestavení:: mscorlib.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Otevře v FileStream zadané cestě .

Přetížení

Open(String, FileMode, FileAccess, FileShare)	FileStream Otevře v zadané cestě s určeným režimem s přístupem pro čtení, zápis nebo čtení/zápis a zadanou možnost sdílení.
Open(String, FileMode)	FileStream Otevře v zadané cestě s přístupem pro čtení i zápis bez sdílení.
Open(String, FileStreamOptions)	Inicializuje novou instanci FileStream třídy se zadanou cestou, režimem vytváření, oprávněním ke čtení/zápisu a sdílení, přístup ke stejnému souboru, velikosti vyrovnávací paměti, dalším možnostem souboru a velikosti přidělení.
Open(String, FileMode, FileAccess)	FileStream Otevře v zadané cestě se zadaným režimem a přístupem bez sdílení.

Open(String, FileMode, FileAccess, FileShare)

Zdroj:: File.cs

Zdroj:: File.cs

Zdroj:: File.cs

FileStream Otevře v zadané cestě s určeným režimem s přístupem pro čtení, zápis nebo čtení/zápis a zadanou možnost sdílení.

public:
 static System::IO::FileStream ^ Open(System::String ^ path, System::IO::FileMode mode, System::IO::FileAccess access, System::IO::FileShare share);

public static System.IO.FileStream Open (string path, System.IO.FileMode mode, System.IO.FileAccess access, System.IO.FileShare share);

static member Open : string * System.IO.FileMode * System.IO.FileAccess * System.IO.FileShare -> System.IO.FileStream

Public Shared Function Open (path As String, mode As FileMode, access As FileAccess, share As FileShare) As FileStream

Parametry

path: String

Soubor, který se má otevřít.

mode: FileMode

Hodnota FileMode , která určuje, zda je soubor vytvořen, pokud neexistuje, a určuje, zda je obsah existujících souborů zachován nebo přepsán.

access: FileAccess

Hodnota FileAccess , která určuje operace, které lze se souborem provést.

share: FileShare

Hodnota FileShare určující typ přístupu, který mají ostatní vlákna k souboru.

Návraty

FileStream

Na FileStream zadané cestě s určeným režimem s přístupem pro čtení, zápis nebo čtení/zápis a zadanou možností sdílení.

Výjimky

ArgumentException

.NET Framework a .NET Core verze starší než 2.1: path je řetězec nulové délky, obsahuje pouze prázdné znaky nebo obsahuje jeden nebo více neplatných znaků. Na neplatné znaky se můžete dotazovat pomocí metody .GetInvalidPathChars()

-nebo-

access zadané Read a mode zadané Create, CreateNew, Truncatenebo Append.

ArgumentNullException

path je null.

PathTooLongException

Zadaná cesta, název souboru nebo obojí překračují maximální délku definovanou systémem.

DirectoryNotFoundException

Zadaná cesta je neplatná (například se nachází na nenamapované jednotce).

IOException

Při otevírání souboru došlo ke vstupně-výstupní chybě.

UnauthorizedAccessException

path zadal soubor, který je jen pro čtení a access není Read.

-nebo-

path zadal(a) adresář.

-nebo-

Volající nemá požadované oprávnění.

-nebo-

mode je Create a zadaný soubor je skrytý soubor.

ArgumentOutOfRangeException

mode, accessnebo share zadal neplatnou hodnotu.

FileNotFoundException

Soubor zadaný v path souboru nebyl nalezen.

NotSupportedException

path je v neplatném formátu.

Příklady

Následující příklad otevře soubor s přístupem jen pro čtení a s zakázaným sdílením souborů.

using namespace System;
using namespace System::IO;
using namespace System::Text;

int main()
{
   String^ path = "c:\\temp\\MyTest.txt";
   
   // Create the file if it does not exist.
   if (  !File::Exists( path ) )
   {
      // Create the file.
      FileStream^ fs = File::Create( path );
      try
      {
         array<Byte>^info = (gcnew UTF8Encoding( true ))->GetBytes( "This is some text in the file." );
         
         // Add some information to the file.
         fs->Write( info, 0, info->Length );
      }
      finally
      {
         if ( fs )
                  delete (IDisposable^)fs;
      }
   }
   
   // Open the stream and read it back.
   FileStream^ fs = File::Open( path, FileMode::Open, FileAccess::Read, FileShare::None );
   try
   {
      array<Byte>^b = gcnew array<Byte>(1024);
      UTF8Encoding^ temp = gcnew UTF8Encoding( true );
      while ( fs->Read( b, 0, b->Length ) > 0 )
      {
         Console::WriteLine( temp->GetString( b ) );
      }
      try
      {
         // Try to get another handle to the same file.
         FileStream^ fs2 = File::Open( path, FileMode::Open );
         try
         {
            // Do some task here.
         }
         finally
         {
            if ( fs2 )
                        delete (IDisposable^)fs2;
         }
      }
      catch ( Exception^ e ) 
      {
         Console::Write( "Opening the file twice is disallowed." );
         Console::WriteLine( ", as expected: {0}", e );
      }
   }
   finally
   {
      if ( fs )
            delete (IDisposable^)fs;
   }
}

using System;
using System.IO;
using System.Text;

class Test
{
    public static void Main()
    {
        string path = @"c:\temp\MyTest.txt";

        // Create the file if it does not exist.
        if (!File.Exists(path))
        {
            // Create the file.
            using (FileStream fs = File.Create(path))
            {
                Byte[] info = new UTF8Encoding(true).GetBytes("This is some text in the file.");

                // Add some information to the file.
                fs.Write(info, 0, info.Length);
            }
        }

        // Open the stream and read it back.
        using (FileStream fs = File.Open(path, FileMode.Open, FileAccess.Read, FileShare.None))
        {
            byte[] b = new byte[1024];
            UTF8Encoding temp = new UTF8Encoding(true);

            while (fs.Read(b,0,b.Length) > 0)
            {
                Console.WriteLine(temp.GetString(b));
            }

            try
            {
                // Try to get another handle to the same file.
                using (FileStream fs2 = File.Open(path, FileMode.Open))
                {
                    // Do some task here.
                }
            }
            catch (Exception e)
            {
                Console.Write("Opening the file twice is disallowed.");
                Console.WriteLine(", as expected: {0}", e.ToString());
            }
        }
    }
}

open System.IO
open System.Text

let path = @"c:\temp\MyTest.txt"

// Create the file if it does not exist.
if File.Exists path |> not then
    // Create the file.
    use fs = File.Create path

    let info =
        UTF8Encoding(true)
            .GetBytes "This is some text in the file."

    // Add some information to the file.
    fs.Write(info, 0, info.Length)

// Open the stream and read it back.
do
    use fs =
        File.Open(path, FileMode.Open, FileAccess.Read, FileShare.None)

    let b = Array.zeroCreate 1024
    let temp = UTF8Encoding true

    while fs.Read(b, 0, b.Length) > 0 do
        printfn $"{temp.GetString b}"

    try
        // Try to get another handle to the same file.
        use fs2 = File.Open(path, FileMode.Open)
        // Do some task here.
        ()
    with
    | e -> printf "Opening the file twice is disallowed, as expected: {e}"

Imports System.IO
Imports System.Text

Public Class Test
  Public Shared Sub Main()
    Dim path As String = "c:\temp\MyTest.txt"

    ' Create the file if it does not exist. 
    If Not File.Exists(path) Then
      ' Create the file.
      Using fs As FileStream = File.Create(path)
        Dim info As Byte() = New UTF8Encoding(True).GetBytes("This is some text in the file.")

        ' Add some information to the file.
        fs.Write(info, 0, info.Length)
      End Using
    End If

    ' Open the stream and read it back.
    Using fs As FileStream = File.Open(path, FileMode.Open, FileAccess.Read, FileShare.None)
      Dim b(1023) As Byte
      Dim temp As UTF8Encoding = New UTF8Encoding(True)

      Do While fs.Read(b, 0, b.Length) > 0
        Console.WriteLine(temp.GetString(b))
      Loop

      Try
        ' Try to get another handle to the same file. 
        Using fs2 As FileStream = File.Open(path, FileMode.Open)
          ' Do some task here.
        End Using
      Catch e As Exception
        Console.Write("Opening the file twice is disallowed.")
        Console.WriteLine(", as expected: {0}", e.ToString())
      End Try

    End Using

  End Sub
End Class

Poznámky

Parametr path může zadat relativní nebo absolutní informace o cestě. Informace o relativní cestě jsou vykládány jako relativní k aktuálnímu pracovnímu adresáři. Pokud chcete získat aktuální pracovní adresář, přečtěte si téma GetCurrentDirectory.

Seznam běžných vstupně-výstupních úloh najdete v tématu Běžné vstupně-výstupní úlohy.

Viz také

Platí pro

Open(String, FileMode)

Zdroj:: File.cs

Zdroj:: File.cs

Zdroj:: File.cs

FileStream Otevře v zadané cestě s přístupem pro čtení i zápis bez sdílení.

public:
 static System::IO::FileStream ^ Open(System::String ^ path, System::IO::FileMode mode);

public static System.IO.FileStream Open (string path, System.IO.FileMode mode);

static member Open : string * System.IO.FileMode -> System.IO.FileStream

Public Shared Function Open (path As String, mode As FileMode) As FileStream

Parametry

path: String

Soubor, který se má otevřít.

mode: FileMode

Hodnota FileMode , která určuje, zda je soubor vytvořen, pokud neexistuje, a určuje, zda je obsah existujících souborů zachován nebo přepsán.

Návraty

FileStream

Otevřený FileStream v zadaném režimu a cesta, s přístupem pro čtení i zápis a nesdílený.

Výjimky

ArgumentException

ArgumentNullException

path je null.

PathTooLongException

Zadaná cesta, název souboru nebo obojí překračují maximální délku definovanou systémem.

DirectoryNotFoundException

Zadaná cesta je neplatná (například se nachází na nenamapované jednotce).

IOException

Při otevírání souboru došlo ke vstupně-výstupní chybě.

UnauthorizedAccessException

path zadal(a) soubor, který je jen pro čtení.

-nebo-

Tato operace není na aktuální platformě podporovaná.

-nebo-

path zadal(a) adresář.

-nebo-

Volající nemá požadované oprávnění.

-nebo-

mode je Create a zadaný soubor je skrytý soubor.

ArgumentOutOfRangeException

mode zadala neplatnou hodnotu.

FileNotFoundException

Soubor zadaný v path souboru nebyl nalezen.

NotSupportedException

path je v neplatném formátu.

Příklady

Následující příklad kódu vytvoří dočasný soubor a zapíše do něj nějaký text. Příklad pak otevře soubor pomocí T:System.IO.FileMode.Open; to znamená, že pokud soubor ještě neexistuje, nebude vytvořen.

using namespace System;
using namespace System::IO;
using namespace System::Text;

int main()
{
   // Create a temporary file, and put some data into it.
   String^ path = Path::GetTempFileName();
   FileStream^ fs = File::Open( path, FileMode::Open, FileAccess::Write, FileShare::None );
   try
   {
      array<Byte>^info = (gcnew UTF8Encoding( true ))->GetBytes( "This is some text in the file." );
      
      // Add some information to the file.
      fs->Write( info, 0, info->Length );
   }
   finally
   {
      if ( fs )
            delete (IDisposable^)fs;
   }

   // Open the stream and read it back.
   fs = File::Open( path, FileMode::Open );
   try
   {
      array<Byte>^b = gcnew array<Byte>(1024);
      UTF8Encoding^ temp = gcnew UTF8Encoding( true );
      while ( fs->Read( b, 0, b->Length ) > 0 )
      {
         Console::WriteLine( temp->GetString( b ) );
      }
   }
   finally
   {
      if ( fs )
            delete (IDisposable^)fs;
   }
}

using System;
using System.IO;
using System.Text;

class Test
{
    public static void Main()
    {
        // Create a temporary file, and put some data into it.
        string path = Path.GetTempFileName();
        using (FileStream fs = File.Open(path, FileMode.Open, FileAccess.Write, FileShare.None))
        {
            Byte[] info = new UTF8Encoding(true).GetBytes("This is some text in the file.");
            // Add some information to the file.
            fs.Write(info, 0, info.Length);
        }

        // Open the stream and read it back.
        using (FileStream fs = File.Open(path, FileMode.Open))
        {
            byte[] b = new byte[1024];
            UTF8Encoding temp = new UTF8Encoding(true);

            while (fs.Read(b,0,b.Length) > 0)
            {
                Console.WriteLine(temp.GetString(b));
            }
        }
    }
}

open System.IO
open System.Text

// Create a temporary file, and put some data into it.
let path = Path.GetTempFileName()

do
    use fs =
        File.Open(path, FileMode.Open, FileAccess.Write, FileShare.None)

    let info =
        UTF8Encoding(true)
            .GetBytes "This is some text in the file."
    // Add some information to the file.
    fs.Write(info, 0, info.Length)

// Open the stream and read it back.
do
    use fs = File.Open(path, FileMode.Open)
    let b = Array.zeroCreate 1024
    let temp = UTF8Encoding true

    while fs.Read(b, 0, b.Length) > 0 do
        printfn $"{temp.GetString b}"

Imports System.IO
Imports System.Text

Public Class Test
  Public Shared Sub Main()
  
    ' Create a temporary file, and put some data into it. 
    Dim path1 As String = Path.GetTempFileName()
    Using fs As FileStream = File.Open(path1, FileMode.Open, FileAccess.Write, FileShare.None)
      Dim info As Byte() = New UTF8Encoding(True).GetBytes("This is some text in the file.")
      ' Add some information to the file.
      fs.Write(info, 0, info.Length)
    End Using

    ' Open the stream and read it back. 
    Using fs As FileStream = File.Open(path1, FileMode.Open)
      Dim b(1023) As Byte
      Dim temp As UTF8Encoding = New UTF8Encoding(True)
      Do While fs.Read(b, 0, b.Length) > 0
        Console.WriteLine(temp.GetString(b))
      Loop
    End Using

  End Sub
End Class

Poznámky

Seznam běžných vstupně-výstupních úloh najdete v tématu Běžné vstupně-výstupní úlohy.

Viz také

Platí pro

Open(String, FileStreamOptions)

Zdroj:: File.cs

Zdroj:: File.cs

Zdroj:: File.cs

Inicializuje novou instanci FileStream třídy se zadanou cestou, režimem vytváření, oprávněním ke čtení/zápisu a sdílení, přístup ke stejnému souboru, velikosti vyrovnávací paměti, dalším možnostem souboru a velikosti přidělení.

public:
 static System::IO::FileStream ^ Open(System::String ^ path, System::IO::FileStreamOptions ^ options);

public static System.IO.FileStream Open (string path, System.IO.FileStreamOptions options);

static member Open : string * System.IO.FileStreamOptions -> System.IO.FileStream

Public Shared Function Open (path As String, options As FileStreamOptions) As FileStream

Parametry

path: String

Cesta k souboru, který se má otevřít.

options: FileStreamOptions

Objekt, který popisuje volitelné FileStream parametry, které se mají použít.

Návraty

FileStream

Instance FileStream , která zabalí otevřený soubor.

Poznámky

FileStream(String, FileStreamOptions) pro informace o výjimkách.

Platí pro

Open(String, FileMode, FileAccess)

Zdroj:: File.cs

Zdroj:: File.cs

Zdroj:: File.cs

FileStream Otevře v zadané cestě se zadaným režimem a přístupem bez sdílení.

public:
 static System::IO::FileStream ^ Open(System::String ^ path, System::IO::FileMode mode, System::IO::FileAccess access);

public static System.IO.FileStream Open (string path, System.IO.FileMode mode, System.IO.FileAccess access);

static member Open : string * System.IO.FileMode * System.IO.FileAccess -> System.IO.FileStream

Public Shared Function Open (path As String, mode As FileMode, access As FileAccess) As FileStream

Parametry

path: String

Soubor, který se má otevřít.

mode: FileMode

Hodnota FileMode , která určuje, zda je soubor vytvořen, pokud neexistuje, a určuje, zda je obsah existujících souborů zachován nebo přepsán.

access: FileAccess

Hodnota FileAccess , která určuje operace, které lze se souborem provést.

Návraty

FileStream

Nesdílené FileStream , které poskytuje přístup k zadanému souboru se zadaným režimem a přístupem.

Výjimky

ArgumentException

-nebo-

access zadané Read a mode zadané Create, CreateNew, Truncatenebo Append.

ArgumentNullException

path je null.

PathTooLongException

Zadaná cesta, název souboru nebo obojí překračují maximální délku definovanou systémem.

DirectoryNotFoundException

Zadaná cesta je neplatná (například se nachází na nenamapované jednotce).

IOException

Při otevírání souboru došlo ke vstupně-výstupní chybě.

UnauthorizedAccessException

path zadal soubor, který je jen pro čtení a access není Read.

-nebo-

path zadal(a) adresář.

-nebo-

Volající nemá požadované oprávnění.

-nebo-

mode je Create a zadaný soubor je skrytý soubor.

ArgumentOutOfRangeException

mode nebo access zadal neplatnou hodnotu.

FileNotFoundException

Soubor zadaný v path souboru nebyl nalezen.

NotSupportedException

path je v neplatném formátu.

Příklady

Následující příklad otevře soubor s přístupem jen pro čtení.


using namespace System;
using namespace System::IO;
using namespace System::Text;

int main()
{
    // This sample assumes that you have a folder named "c:\temp" on your computer.
    String^ filePath = "c:\\temp\\MyTest.txt";
    // Delete the file if it exists.
    if (File::Exists( filePath ))
    {
        File::Delete( filePath );
    }
    // Create the file.
    FileStream^ fs = File::Create( filePath );
    try
    {
        array<Byte>^ info = ( gcnew UTF8Encoding( true ))->GetBytes( "This is some text in the file." );
        
        // Add some information to the file.
        fs->Write( info, 0, info->Length );
    }
    finally
    {
        if ( fs )
            delete (IDisposable^)fs;
    }

    // Open the stream and read it back.
    fs = File::Open( filePath, FileMode::Open, FileAccess::Read );
    try
    {
        array<Byte>^ b = gcnew array<Byte>(1024);
        UTF8Encoding^ temp = gcnew UTF8Encoding( true );
        while ( fs->Read( b, 0, b->Length ) > 0 )
        {
            Console::WriteLine( temp->GetString( b ) );
        }
        try
        {
            // Try to write to the file.
            fs->Write( b, 0, b->Length );
        }
        catch ( Exception^ e ) 
        {
            Console::WriteLine( "Writing was disallowed, as expected: {0}", e->ToString() );
        }
    }
    finally
    {
        if ( fs )
            delete (IDisposable^)fs;
    }
}

using System;
using System.IO;
using System.Text;

class Test
{
    public static void Main()
    {
        // This sample assumes that you have a folder named "c:\temp" on your computer.
        string filePath = @"c:\temp\MyTest.txt";

        // Delete the file if it exists.
        if (File.Exists(filePath))
        {
            File.Delete(filePath);
        }

        // Create the file.
        using (FileStream fs = File.Create(filePath))
        {
            Byte[] info = new UTF8Encoding(true).GetBytes("This is some text in the file.");
            // Add some information to the file.
            fs.Write(info, 0, info.Length);
        }

        // Open the stream and read it back.
        using (FileStream fs = File.Open(filePath, FileMode.Open, FileAccess.Read))
        {
            byte[] b = new byte[1024];
            UTF8Encoding temp = new UTF8Encoding(true);

            while (fs.Read(b,0,b.Length) > 0)
            {
                Console.WriteLine(temp.GetString(b));
            }

            try
            {
                // Try to write to the file.
                fs.Write(b,0,b.Length);
            }
            catch (Exception e)
            {
                Console.WriteLine("Writing was disallowed, as expected: {0}", e.ToString());
            }
        }
    }
}

open System.IO
open System.Text

// This sample assumes that you have a folder named "c:\temp" on your computer.
let filePath = @"c:\temp\MyTest.txt"

// Delete the file if it exists.
if File.Exists filePath then
    File.Delete filePath

// Create the file.
do
    use fs = File.Create filePath

    let info =
        UTF8Encoding(true)
            .GetBytes "This is some text in the file."
    // Add some information to the file.
    fs.Write(info, 0, info.Length)

// Open the stream and read it back.
do
    use fs =
        File.Open(filePath, FileMode.Open, FileAccess.Read)

    let b = Array.zeroCreate 1024
    let temp = UTF8Encoding true

    while fs.Read(b, 0, b.Length) > 0 do
        printfn $"{temp.GetString b}"

    try
        // Try to write to the file.
        fs.Write(b, 0, b.Length)
    with
    | e -> printfn $"Writing was disallowed, as expected: {e}"

Imports System.IO
Imports System.Text

Public Class Test
  Public Shared Sub Main()
    ' This sample assumes that you have a folder named "c:\temp" on your computer. 
    Dim filePath As String = "c:\temp\MyTest.txt"

    ' Delete the file if it exists. 
    If File.Exists(filePath) Then
      File.Delete(filePath)
    End If

    ' Create the file.
    Using fs As FileStream = File.Create(filePath)
      Dim info As Byte() = New UTF8Encoding(True).GetBytes("This is some text in the file.")

      ' Add some information to the file.
      fs.Write(info, 0, info.Length)
    End Using

    ' Open the stream and read it back.
    Using fs As FileStream = File.Open(filePath, FileMode.Open, FileAccess.Read)
      Dim b(1023) As Byte
      Dim temp As UTF8Encoding = New UTF8Encoding(True)

      ' Display the information on the console. 
      Do While fs.Read(b, 0, b.Length) > 0
        Console.WriteLine(temp.GetString(b))
      Loop

      Try
        ' Try to write to the file
        fs.Write(b, 0, b.Length)
      Catch e As Exception
        Console.WriteLine("Writing was disallowed, as expected: " & e.ToString())
      End Try

    End Using

  End Sub
End Class

Poznámky

Viz také

Platí pro

Sdílet prostřednictvím

File.Open Metoda

Definice

Přetížení

Open(String, FileMode, FileAccess, FileShare)

Parametry

Návraty

Výjimky

Příklady

Poznámky

Viz také

Platí pro

Open(String, FileMode)

Parametry

Návraty

Výjimky

Příklady

Poznámky

Viz také

Platí pro

Open(String, FileStreamOptions)

Parametry

Návraty

Poznámky

Platí pro

Open(String, FileMode, FileAccess)

Parametry

Návraty

Výjimky

Příklady

Poznámky

Viz také

Platí pro

Další materiály