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

Definition

Namnområde:
Microsoft.VisualBasic.FileIO
Sammansättning:
Microsoft.VisualBasic.dll

Skriver data till en binär fil.

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)

Parametrar

file
String

Sökväg och namn på filen som ska skrivas till.

data
Byte[]

Data som ska skrivas till filen.

append
Boolean

True för att lägga till i filinnehållet; False för att skriva över filinnehållet. Standard är False.

Undantag

ArgumentException

Sökvägen är inte giltig av någon av följande orsaker: det är en sträng med noll längd. den innehåller endast tomt utrymme. den innehåller ogiltiga tecken. eller så är det en enhetssökväg (börjar med \\.\); det slutar med ett avslutande snedstreck.

ArgumentNullException

file är Nothing.

FileNotFoundException

Filen finns inte.

IOException

Filen används av en annan process eller så uppstår ett I/O-fel.

PathTooLongException

Sökvägen överskrider den systemdefinierade maximala längden.

NotSupportedException

Ett fil- eller katalognamn i sökvägen innehåller ett kolon (:) eller är i ett ogiltigt format.

OutOfMemoryException

Det finns inte tillräckligt med minne för att skriva strängen för bufferten.

SecurityException

Användaren saknar nödvändiga behörigheter för att visa sökvägen.

Exempel

I det här exemplet läggs datamatrisen CustomerData till i filen CollectedData.

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

Kommentarer

Om den angivna sökvägen, exklusive filnamnet, inte är giltig utlöses ett DirectoryNotFoundException undantag. Om sökvägen är giltig men filen inte finns skapas filen.

Note

Metoden WriteAllBytes öppnar en fil, skriver till den och stänger den sedan. Kod som använder WriteAllBytes metoden är enklare än kod som använder ett BinaryWriter objekt. Men om du lägger till data i en fil med hjälp av en loop kan ett BinaryWriter objekt ge bättre prestanda eftersom du bara behöver öppna och stänga filen en gång.

I följande tabell visas ett exempel på en uppgift som involverar My.Computer.FileSystem.WriteAllBytes metoden.

Till Se
Skriva till en binär fil How to: Write to Binary Files in Visual Basic

Gäller för