FileSystemProxy.WriteAllBytes(String, Byte[], Boolean) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee schrijft u gegevens naar een binair bestand.
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 -> unitPublic 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
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.
file is Nothing.
Het bestand bestaat niet.
Het bestand wordt gebruikt door een ander proces of er treedt een I/O-fout op.
Het pad overschrijdt de door het systeem gedefinieerde maximumlengte.
Een bestands- of mapnaam in het pad bevat een dubbele punt (:) of heeft een ongeldige indeling.
Er is onvoldoende geheugen om de tekenreeks naar buffer te schrijven.
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 te schrijven naar binaire bestanden |