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

Definice

Obor názvů:
Microsoft.VisualBasic.MyServices
Sestavení:
Microsoft.VisualBasic.dll

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

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

Cesta a název souboru, do které se má zapisovat.

data
Byte[]

Data, která se mají zapsat do souboru.

append
Boolean

True k připojení k obsahu souboru; False k přepsání obsahu souboru. Výchozí hodnota 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 je to cesta zařízení (začíná na \\.\); končí koncové lomítko.

ArgumentNullException

file je Nothing.

FileNotFoundException

Soubor neexistuje.

IOException

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

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

Pro zápis ř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.

Note

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 poskytovat lepší výkon, BinaryWriter protože soubor stačí otevřít a zavřít jenom jednou.

Následující tabulka uvádí příklad úkolu zahrnujícího metodu My.Computer.FileSystem.WriteAllBytes .

To Podívejte se
Zápis do binárního souboru Postupy: Zápis do binárních souborů

Platí pro

Viz také