Udostępnij za pośrednictwem


FileMode Wyliczenie

Definicja

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
FileMode
Atrybuty

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ż