Sdílet prostřednictvím


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

Definice

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

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.

file je Nothing.

Soubor neexistuje.

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

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

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

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

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

Platí pro