FileMode Výčet

  • Reference

Definice

Obor názvů:
System.IO
Sestavení:
mscorlib.dll, System.IO.FileSystem.Primitives.dll
Sestavení:
System.Runtime.dll
Sestavení:
System.IO.FileSystem.Primitives.dll
Sestavení:
mscorlib.dll
Sestavení:
netstandard.dll

Určuje, jak má operační systém otevřít soubor.

public enum class FileMode
public enum FileMode
[System.Serializable]
public enum FileMode
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public enum FileMode
type FileMode = 
[<System.Serializable>]
type FileMode = 
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type FileMode = 
Public Enum FileMode
Dědičnost
Object
ValueType
Enum
FileMode
Atributy
SerializableAttribute ComVisibleAttribute

Pole

Append 6

Otevře soubor, pokud existuje, a hledá až na konec souboru, nebo vytvoří nový soubor. To vyžaduje Append oprávnění. FileMode.Append lze použít pouze ve spojení s FileAccess.Write. Pokus o umístění před koncem souboru vyvolá IOException výjimku a jakýkoli pokus o čtení selže a vyvolá NotSupportedException výjimku.
Create 2

Určuje, že operační systém by měl vytvořit nový soubor. Pokud už soubor existuje, přepíše se. To vyžaduje Write oprávnění. FileMode.Create je ekvivalentní požadavku, že pokud soubor neexistuje, použijte CreateNew. V opačném případě použijte Truncate. Pokud soubor již existuje, ale jedná se o skrytý soubor, UnauthorizedAccessException vyvolá se výjimka.
CreateNew 1

Určuje, že operační systém by měl vytvořit nový soubor. To vyžaduje Write oprávnění. Pokud soubor již existuje, IOException vyvolá se výjimka.
Open 3

Určuje, že operační systém má otevřít existující soubor. Možnost otevřít soubor závisí na hodnotě určené výčtem FileAccess . Pokud FileNotFoundException soubor neexistuje, vyvolá se výjimka.
OpenOrCreate 4

Určuje, že operační systém by měl otevřít soubor, pokud existuje; jinak by měl být vytvořen nový soubor. Pokud je soubor otevřen pomocí FileAccess.Readpříkazu , Read je vyžadováno oprávnění. Pokud je FileAccess.Writepřístup k souboru , Write je potřeba oprávnění. Pokud je soubor otevřen pomocí FileAccess.ReadWritepříkazu , jsou vyžadována oprávnění i ReadWrite oprávnění.
Truncate 5

Určuje, že operační systém má otevřít existující soubor. Při otevření souboru by měl být zkrácen tak, aby jeho velikost byla nula bajtů. To vyžaduje Write oprávnění. Pokusy o čtení ze souboru otevřeného s FileMode.Truncate způsobí ArgumentException výjimku.

Příklady

Následující FileStream konstruktor otevře existující soubor (FileMode.Open).

FileStream^ s2 = gcnew FileStream( name, FileMode::Open, FileAccess::Read, FileShare::Read );

FileStream s2 = new FileStream(name, FileMode.Open, FileAccess.Read, FileShare.Read);

Dim s2 As New FileStream(name, FileMode.Open, FileAccess.Read, FileShare.Read)

Poznámky

Příklad vytvoření souboru a zápisu textu do souboru najdete v tématu Postupy: Zápis textu do souboru. Příklad čtení textu ze souboru najdete v tématu Postupy: Čtení textu ze souboru. Příklad čtení z binárního souboru a zápisu do binárního souboru najdete v tématu Postupy: Čtení a zápis do nově vytvořeného datového souboru.

Parametr FileMode je zadán v mnoha konstruktorech pro FileStream, IsolatedStorageFileStreama v Open metodách File a FileInfo k řízení způsobu otevření souboru.

FileMode parametry určují, jestli se soubor přepíše, vytvoří, otevře nebo zkombinuje. Slouží Open k otevření existujícího souboru. K připojení k souboru použijte Append. Pokud chcete soubor zkrátit nebo vytvořit soubor, pokud neexistuje, použijte Create.

Platí pro

Viz také