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

Reference

Definice

Obor názvů:: Microsoft.VisualBasic.FileIO

Sestavení:: Microsoft.VisualBasic.Core.dll

Sestavení:: Microsoft.VisualBasic.dll

Zdroj:: FileSystem.vb

Zdroj:: FileSystem.vb

Zdroj:: FileSystem.vb

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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

Platí pro