Udostępnij za pośrednictwem


FileSystem.WriteAllBytes(String, Byte[], Boolean) Metoda

Definicja

Zapisuje dane w pliku binarnym.

public:
 static void WriteAllBytes(System::String ^ file, cli::array <System::Byte> ^ data, bool append);
public static void WriteAllBytes (string file, byte[] data, bool append);
static member WriteAllBytes : string * byte[] * bool -> unit
Public Shared Sub WriteAllBytes (file As String, data As Byte(), append As Boolean)

Parametry

file
String

Ścieżka i nazwa pliku do zapisania.

data
Byte[]

Dane, które mają być zapisywane w pliku.

append
Boolean

True w celu dołączenia do zawartości pliku; False aby zastąpić zawartość pliku. Wartość domyślna to False.

Wyjątki

Ścieżka jest nieprawidłowa z jednego z następujących powodów: jest to ciąg o zerowej długości; zawiera tylko białe znaki; zawiera nieprawidłowe znaki; lub jest to ścieżka urządzenia (rozpoczyna się od \\.\); kończy się ukośnikiem.

file to Nothing.

Plik nie istnieje.

Plik jest używany przez inny proces lub występuje błąd we/wy.

Ścieżka przekracza maksymalną długość zdefiniowaną przez system.

Nazwa pliku lub katalogu w ścieżce zawiera dwukropek (:) lub jest w nieprawidłowym formacie.

Za mało pamięci, aby zapisać ciąg w buforze.

Użytkownik nie ma niezbędnych uprawnień do wyświetlania ścieżki.

Przykłady

W tym przykładzie tablica CustomerData danych jest dołączana do pliku CollectedData.

My.Computer.FileSystem.WriteAllBytes(
  "C:\MyDocuments\CustomerData", CustomerData, True)

Uwagi

Jeśli określona ścieżka, z wyłączeniem nazwy pliku, jest nieprawidłowa, DirectoryNotFoundException zostanie zgłoszony wyjątek. Jeśli ścieżka jest prawidłowa, ale plik nie istnieje, zostanie utworzony plik.

Uwaga

Metoda WriteAllBytes otwiera plik, zapisuje go, a następnie zamyka go. Kod używający WriteAllBytes metody jest prostszy niż kod, który używa BinaryWriter obiektu. Jeśli jednak dodasz dane do pliku przy użyciu pętli, obiekt może zapewnić lepszą wydajność, BinaryWriter ponieważ wystarczy otworzyć i zamknąć plik raz.

W poniższej tabeli wymieniono przykład zadania obejmującego metodę My.Computer.FileSystem.WriteAllBytes .

Działanie Zobacz
Zapis w pliku binarnym Porady: zapis w plikach binarnych w Visual Basic

Dotyczy