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

Definíció

Névtér:

Microsoft.VisualBasic.MyServices

Szerelvény:

Microsoft.VisualBasic.Forms.dll

Forrás:

FileSystemProxy.vb

Adatokat ír bináris fájlba.

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)

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	Útmutató: Írás bináris fájlokba

Lásd még

• Objects (Visual Basic)
• Beírás bináris fájlba a Visual Basic
• Az Visual Basic