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

Odwołanie

Definicja

Przestrzeń nazw:: Microsoft.VisualBasic.MyServices

Zestaw:: Microsoft.VisualBasic.dll

Zestaw:: Microsoft.VisualBasic.Forms.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Zapisuje dane w pliku binarnym.

public:
 void WriteAllBytes(System::String ^ file, cli::array <System::Byte> ^ data, bool append);

public void WriteAllBytes (string file, byte[] data, bool append);

member this.WriteAllBytes : string * byte[] * bool -> unit

Public Sub WriteAllBytes (file As String, data As Byte(), append As Boolean)

Parametry

file: String

Ścieżka i nazwa pliku do zapisania.

data: Byte[]

Dane do zapisania 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ę końcowym 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 do zapisania ciągu do buforu.

SecurityException

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

Przykłady

Ten przykład dołącza tablicę CustomerData danych 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 korzystający z WriteAllBytes metody jest prostszy niż kod, który używa BinaryWriter obiektu. Jednak w przypadku dodawania danych do pliku przy użyciu pętli obiekt może zapewnić lepszą wydajność, BinaryWriter ponieważ trzeba otworzyć i zamknąć plik tylko raz.

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

Działanie	Zobacz
Zapis w pliku binarnym	Instrukcje: Zapisywanie w plikach binarnych

Dotyczy

Udostępnij za pośrednictwem