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á 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 vyhledání pozice 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í k vyžádání, že pokud soubor neexistuje, použijte CreateNew; jinak použijte Truncate. Pokud soubor již existuje, ale je skrytým souborem, 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 by měl otevřít existující soubor. Možnost otevřít soubor je závislá 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 se měl vytvořit nový soubor. Pokud je soubor otevřen s oprávněním FileAccess.Read, Read je vyžadováno oprávnění. Pokud je FileAccess.Writepřístup k souboru, Write je vyžadováno oprávnění. Pokud je soubor otevřen s FileAccess.ReadWrite, jsou vyžadována obě Read i Write oprávnění.
Truncate 5

Určuje, že operační systém by měl otevřít existující soubor. Když je soubor otevřen, měl by být zkrácen tak, aby jeho velikost byla nula bajtů. To vyžaduje Write oprávnění. Pokusí se číst ze souboru otevřeného ArgumentException s FileMode.Truncate příčinou výjimky.

Příklady

FileStream Následující 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ápis 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ápis 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 řízení způsobu otevření souboru.

FileMode parametry určují, jestli je soubor přepsán, vytvořen, otevřen nebo jeho kombinace. Slouží Open k otevření existujícího souboru. Chcete-li připojit k souboru, použijte Append. Pokud chcete soubor zkrátit nebo vytvořit soubor, pokud neexistuje, použijte Create.

Platí pro

Viz také