File.OpenWrite(String) 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 opent u een bestaand bestand of maakt u een nieuw bestand voor schrijven.
public:
static System::IO::FileStream ^ OpenWrite(System::String ^ path);
public static System.IO.FileStream OpenWrite(string path);
static member OpenWrite : string -> System.IO.FileStream
Public Shared Function OpenWrite (path As String) As FileStream
Parameters
- path
- String
Het bestand dat moet worden geopend voor schrijven.
Retouren
Een niet-gedeeld FileStream object op het opgegeven pad met Write toegang.
Uitzonderingen
De beller heeft niet de vereiste machtiging.
– of –
path een bestand of map met het kenmerk Alleen-lezen opgegeven.
.NET Framework en .NET Core-versies ouder dan 2.1: path is een tekenreeks met lengte nul, bevat alleen witruimte of bevat een of meer ongeldige tekens. U kunt een query uitvoeren op ongeldige tekens met behulp van de GetInvalidPathChars() methode.
path is null.
Het opgegeven pad, de bestandsnaam of beide overschrijden de door het systeem gedefinieerde maximumlengte.
Het opgegeven pad is ongeldig (bijvoorbeeld op een niet-toegewezen station).
path heeft een ongeldige indeling.
Voorbeelden
In het volgende voorbeeld wordt een bestand geopend voor lezen en schrijven.
using System;
using System.IO;
using System.Text;
class Test
{
public static void Main()
{
string path = @"c:\temp\MyTest.txt";
// Open the stream and write to it.
using (FileStream fs = File.OpenWrite(path))
{
Byte[] info =
new UTF8Encoding(true).GetBytes("This is to test the OpenWrite method.");
// Add some information to the file.
fs.Write(info, 0, info.Length);
}
// Open the stream and read it back.
using (FileStream fs = File.OpenRead(path))
{
byte[] b = new byte[1024];
UTF8Encoding temp = new UTF8Encoding(true);
while (fs.Read(b,0,b.Length) > 0)
{
Console.WriteLine(temp.GetString(b));
}
}
}
}
open System.IO
open System.Text
let path = @"c:\temp\MyTest.txt"
// Open the stream and write to it.
do
use fs = File.OpenWrite path
let info =
UTF8Encoding(true)
.GetBytes "This is to test the OpenWrite method."
// Add some information to the file.
fs.Write(info, 0, info.Length)
// Open the stream and read it back.
do
use fs = File.OpenRead path
let b = Array.zeroCreate 1024
let temp = UTF8Encoding true
while fs.Read(b, 0, b.Length) > 0 do
printfn $"{temp.GetString b}"
Imports System.IO
Imports System.Text
Public Class Test
Public Shared Sub Main()
Dim path As String = "c:\temp\MyTest.txt"
' Open the stream and write to it.
Using fs As FileStream = File.OpenWrite(path)
Dim info As Byte() = _
New UTF8Encoding(True).GetBytes("This is to test the OpenWrite method.")
' Add some information to the file.
fs.Write(info, 0, info.Length)
End Using
'Open the stream and read it back.
Using fs As FileStream = File.OpenRead(path)
Dim b(1023) As Byte
Dim temp As UTF8Encoding = New UTF8Encoding(True)
Do While fs.Read(b, 0, b.Length) > 0
Console.WriteLine(temp.GetString(b))
Loop
End Using
End Sub
End Class
Opmerkingen
Deze methode is gelijk aan de overbelasting van de FileStream(String, FileMode, FileAccess, FileShare) constructor met de bestandsmodus ingesteld op OpenOrCreate, de toegang ingesteld op Writeen de sharemodus ingesteld op None.
Met de OpenWrite methode wordt een bestand geopend als er al een bestaat voor het bestandspad of als er nog geen nieuw bestand bestaat. Voor een bestaand bestand wordt de nieuwe tekst niet toegevoegd aan de bestaande tekst. In plaats daarvan worden de bestaande tekens overschreven met de nieuwe tekens. Als u een langere tekenreeks overschrijft (zoals 'Dit is een test van de Methode OpenWrite') met een kortere tekenreeks (zoals 'Tweede uitvoering'),bevat het bestand een combinatie van de tekenreeksen ('Tweede runtest van de OpenWrite-methode').
De path parameter kan relatieve of absolute padinformatie opgeven. Relatieve padinformatie wordt geïnterpreteerd als relatief ten opzichte van de huidige werkmap. Gebruik de GetCurrentDirectory methode om de huidige werkmap te verkrijgen.
Het geretourneerde FileStream bestand biedt geen ondersteuning voor lezen. Als u een bestand wilt openen voor zowel lezen als schrijven, gebruikt u Open.
Zie Algemene I/O-taken voor een lijst met algemene I/O-taken.