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

Definice

Obor názvů:

Microsoft.VisualBasic.FileIO

Sestavení:

Microsoft.VisualBasic.Core.dll

Zdroj:

FileSystem.vb

Zapíše data do binárního souboru.

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

Cesta a název souboru, do který se má zapsat.

data

Byte[]

Data, která se mají zapisovat do souboru.

append

Boolean

True připojit k obsahu souboru; False k přepsání obsahu souboru. Výchozí je False.

Výjimky

ArgumentException

Cesta není platná z jednoho z následujících důvodů: jedná se o řetězec nulové délky; obsahuje pouze prázdné znaky; obsahuje neplatné znaky; nebo se jedná o cestu k zařízení (začíná na \\.\); končí koncovým lomítkem.

ArgumentNullException

file je Nothing.

FileNotFoundException

Soubor neexistuje.

IOException

Soubor se používá jiným procesem nebo dojde k chybě vstupně-výstupních operací.

PathTooLongException

Cesta překračuje maximální délku definovanou systémem.

NotSupportedException

Název souboru nebo adresáře v cestě obsahuje dvojtečku (:) nebo je v neplatném formátu.

OutOfMemoryException

K zápisu řetězce do vyrovnávací paměti není dostatek paměti.

SecurityException

Uživatel nemá potřebná oprávnění k zobrazení cesty.

Příklady

Tento příklad připojí datové pole CustomerData k souboru CollectedData.

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

Poznámky

Pokud zadaná cesta s výjimkou názvu souboru není platná, DirectoryNotFoundException vyvolá se výjimka. Pokud je cesta platná, ale soubor neexistuje, vytvoří se soubor.

Poznámka

Metoda WriteAllBytes otevře soubor, zapíše do něj a pak ho zavře. Kód, který používá metodu WriteAllBytes , je jednodušší než kód, který používá BinaryWriter objekt. Pokud ale přidáváte data do souboru pomocí smyčky, může objekt poskytnout lepší výkon, BinaryWriter protože soubor stačí otevřít a zavřít jenom jednou.

V následující tabulce je uveden příklad úlohy zahrnující metodu My.Computer.FileSystem.WriteAllBytes .

Záměr	Seznamte se s
Zápis do binárního souboru	Postupy: Zápis do binárních souborů v jazyce Visual Basic