FileSystem.WriteAllBytes(String, Byte[], Boolean) Metódus

Definíció

Névtér:

Microsoft.VisualBasic.FileIO

Szerelvény:

Microsoft.VisualBasic.Core.dll

Forrás:

FileSystem.vb

Adatokat ír bináris fájlba.

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)

Paraméterek

file

String

A fájl elérési útja és neve.

data

Byte[]

A fájlba írandó adatok.

append

Boolean

True a fájl tartalmának hozzáfűzése; False a fájl tartalmának felülírásához. Az alapértelmezett érték False.

Kivételek

ArgumentException

Az elérési út az alábbi okok egyike miatt nem érvényes: nulla hosszúságú sztring; csak üres helyet tartalmaz; érvénytelen karaktereket tartalmaz; vagy egy eszköz elérési útja (\\.\-val kezdődik); záró perjellel végződik.

ArgumentNullException

file az Nothing.

FileNotFoundException

A fájl nem létezik.

IOException

A fájlt egy másik folyamat használja, vagy I/O-hiba történik.

PathTooLongException

Az elérési út meghaladja a rendszer által megadott maximális hosszt.

NotSupportedException

Az elérési út fájl- vagy könyvtárneve kettőspontot tartalmaz (:) vagy érvénytelen formátumú.

OutOfMemoryException

Nincs elég memória a sztring puffereléshez való írásához.

SecurityException

A felhasználó nem rendelkezik az elérési út megtekintéséhez szükséges engedélyekkel.

Példák

Ez a példa hozzáfűzi az adattömböt CustomerData a fájlhoz CollectedData.

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

Megjegyzések

Ha a megadott elérési út – a fájlnév kivételével – érvénytelen, a rendszer kivételt DirectoryNotFoundException küld. Ha az elérési út érvényes, de a fájl nem létezik, a fájl létrejön.

Note

A WriteAllBytes metódus megnyit egy fájlt, ír rá, majd bezárja. A metódust WriteAllBytes használó kód egyszerűbb, mint az objektumot BinaryWriter használó kód. Ha azonban hurkot használva ad hozzá adatokat egy fájlhoz, az BinaryWriter objektum jobb teljesítményt nyújthat, mert csak egyszer kell megnyitnia és bezárnia a fájlt.

Az alábbi táblázat egy példát sorol fel a metódust érintő feladatra My.Computer.FileSystem.WriteAllBytes .

Címzett	Nézze
Írás bináris fájlba	Beírás bináris fájlokba a Visual Basic