FileMode Wyliczenie

  • Odwołanie

Definicja

Przestrzeń nazw:
System.IO
Zestawy:
mscorlib.dll, System.IO.FileSystem.Primitives.dll
Zestaw:
System.Runtime.dll
Zestaw:
System.IO.FileSystem.Primitives.dll
Zestaw:
mscorlib.dll
Zestaw:
netstandard.dll

Określa sposób otwierania pliku przez system operacyjny.

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
Dziedziczenie
Object
ValueType
Enum
FileMode
Atrybuty
SerializableAttribute ComVisibleAttribute

Pola

Append 6

Otwiera plik, jeśli istnieje i szuka końca pliku, lub tworzy nowy plik. Append Wymaga to uprawnień. FileMode.Append można używać tylko w połączeniu z FileAccess.Write. Próba wyszukiwania pozycji przed końcem pliku zgłasza IOException wyjątek, a próba odczytu kończy się niepowodzeniem i zgłasza NotSupportedException wyjątek.
Create 2

Określa, że system operacyjny powinien utworzyć nowy plik. Jeśli plik już istnieje, zostanie zastąpiony. Write Wymaga to uprawnień. FileMode.Createjest odpowiednikiem żądania, że jeśli plik nie istnieje, użyj ; CreateNeww przeciwnym razie użyj .Truncate Jeśli plik już istnieje, ale jest ukrytym plikiem UnauthorizedAccessException , zgłaszany jest wyjątek.
CreateNew 1

Określa, że system operacyjny powinien utworzyć nowy plik. Write Wymaga to uprawnień. Jeśli plik już istnieje, IOException zgłaszany jest wyjątek.
Open 3

Określa, że system operacyjny powinien otworzyć istniejący plik. Możliwość otwierania pliku zależy od wartości określonej przez FileAccess wyliczenie. Jeśli FileNotFoundException plik nie istnieje, zgłaszany jest wyjątek.
OpenOrCreate 4

Określa, że system operacyjny powinien otworzyć plik, jeśli istnieje; w przeciwnym razie należy utworzyć nowy plik. Jeśli plik jest otwarty za pomocą FileAccess.Readpolecenia , Read wymagane jest uprawnienie. Jeśli dostęp do pliku to FileAccess.Write, Write wymagane jest uprawnienie. Jeśli plik jest otwarty za pomocą FileAccess.ReadWritepolecenia , wymagane są zarówno uprawnienia, jak Read i Write .
Truncate 5

Określa, że system operacyjny powinien otworzyć istniejący plik. Po otwarciu pliku powinien zostać obcięty tak, aby jego rozmiar był zerowy. Write Wymaga to uprawnień. Próby odczytu z pliku otwartego z FileMode.Truncate powodu wyjątku ArgumentException .

Przykłady

Poniższy FileStream konstruktor otwiera istniejący plik (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)

Uwagi

Przykład tworzenia pliku i zapisywania tekstu w pliku można znaleźć w temacie How to: Write Text to a File (Instrukcje: zapisywanie tekstu w pliku). Przykład odczytywania tekstu z pliku można znaleźć w temacie How to: Read Text from a File (Instrukcje: odczytywanie tekstu z pliku). Przykład odczytywania i zapisywania w pliku binarnym można znaleźć w temacie Instrukcje: odczyt i zapis w nowo utworzonym pliku danych.

Parametr FileMode jest określony w wielu konstruktorach dla FileStream, IsolatedStorageFileStreami w Open metodach File i FileInfo do kontrolowania sposobu otwierania pliku.

FileMode parametry określają, czy plik jest zastępowany, tworzony, otwierany lub jego kombinacja. Użyj polecenia Open , aby otworzyć istniejący plik. Aby dołączyć do pliku, użyj polecenia Append. Aby obcinać plik lub utworzyć plik, jeśli nie istnieje, użyj polecenia Create.

Dotyczy

Zobacz też