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

Definicja

Przestrzeń nazw:

Microsoft.VisualBasic.FileIO

Zestaw:

Microsoft.VisualBasic.Core.dll

Źródło:

FileSystem.vb

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

ArgumentException

Ś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.

ArgumentNullException

file to Nothing.

FileNotFoundException

Plik nie istnieje.

IOException

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

PathTooLongException

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

NotSupportedException

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

OutOfMemoryException

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

SecurityException

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