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

Definitie

Naamruimte:
Microsoft.VisualBasic.FileIO
Assembly:
Microsoft.VisualBasic.dll

Hiermee schrijft u gegevens naar een binair bestand.

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)

Parameters

file
String

Het pad en de naam van het bestand dat moet worden geschreven.

data
Byte[]

Gegevens die naar het bestand moeten worden geschreven.

append
Boolean

True om toe te voegen aan de bestandsinhoud; False om de bestandsinhoud te overschrijven. De standaardwaarde is False.

Uitzonderingen

ArgumentException

Het pad is om een van de volgende redenen niet geldig: het is een tekenreeks met lengte nul; het bevat alleen witruimte; bevat ongeldige tekens; of het is een apparaatpad (begint met \\.\); het eindigt met een afsluitende slash.

ArgumentNullException

file is Nothing.

FileNotFoundException

Het bestand bestaat niet.

IOException

Het bestand wordt gebruikt door een ander proces of er treedt een I/O-fout op.

PathTooLongException

Het pad overschrijdt de door het systeem gedefinieerde maximumlengte.

NotSupportedException

Een bestands- of mapnaam in het pad bevat een dubbele punt (:) of heeft een ongeldige indeling.

OutOfMemoryException

Er is onvoldoende geheugen om de tekenreeks naar buffer te schrijven.

SecurityException

De gebruiker beschikt niet over de benodigde machtigingen om het pad weer te geven.

Voorbeelden

In dit voorbeeld wordt de gegevensmatrix CustomerData toegevoegd aan het bestand CollectedData.

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

Opmerkingen

Als het opgegeven pad, met uitzondering van de bestandsnaam, ongeldig is, wordt er een DirectoryNotFoundException uitzondering gegenereerd. Als het pad geldig is, maar het bestand niet bestaat, wordt het bestand gemaakt.

Note

Met de WriteAllBytes methode wordt een bestand geopend, naar het bestand geschreven en vervolgens gesloten. Code die gebruikmaakt van de WriteAllBytes methode is eenvoudiger dan code die gebruikmaakt van een BinaryWriter object. Als u echter gegevens toevoegt aan een bestand met behulp van een lus, kan een BinaryWriter object betere prestaties bieden, omdat u het bestand slechts eenmaal hoeft te openen en sluiten.

De volgende tabel bevat een voorbeeld van een taak die betrekking heeft op de My.Computer.FileSystem.WriteAllBytes methode.

Tot Zien!
Schrijven naar een binair bestand Hoe to: Write to Binary Files in Visual Basic

Van toepassing op