FileStream.Write-Methode

Artikel
08/20/2007

Schreibt einen Block von Bytes unter Verwendung von gepufferten Daten in diesen Stream.

Namespace: System.IO
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Overrides Sub Write ( _
    array As Byte(), _
    offset As Integer, _
    count As Integer _
)
'Usage
Dim instance As FileStream
Dim array As Byte()
Dim offset As Integer
Dim count As Integer

instance.Write(array, offset, count)

public override void Write (
    byte[] array,
    int offset,
    int count
)

public:
virtual void Write (
    array<unsigned char>^ array, 
    int offset, 
    int count
) override

public void Write (
    byte[] array, 
    int offset, 
    int count
)

public override function Write (
    array : byte[], 
    offset : int, 
    count : int
)

Parameter

array
Der Puffer mit den Daten, die in den Stream geschrieben werden sollen.

offset
Der nullbasierte Byteoffset im array, ab dem Bytes in den aktuellen Stream kopiert werden.

count
Die maximale Anzahl an Bytes, die in den aktuellen Stream geschrieben werden sollen.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentNullException	array ist NULL (Nothing in Visual Basic).
ArgumentException	offset und count bezeichnen einen ungültigen Bereich in array.
ArgumentOutOfRangeException	offset oder count ist negativ.
IOException	Ein E/A-Fehler tritt auf. - oder - Ein anderer Thread hat ggf. eine unerwartete Änderung an der Position des vom Betriebssystem verwendeten Dateihandles bewirkt.
ObjectDisposedException	Der Stream ist geschlossen.
NotSupportedException	Die aktuelle Instanz des Streams unterstützt keine Schreibvorgänge.

Hinweise

Diese Methode überschreibt Write.

Der offset-Parameter gibt den Offset des Bytes in array (den Pufferindex) an, ab dem kopiert werden soll, und der count-Parameter gibt die maximale Anzahl der in diesen Stream zu schreibenden Bytes an. Wenn der Schreibvorgang erfolgreich ist, wird die aktuelle Position des Streams um die Anzahl der geschriebenen Bytes nach vorn verschoben. Wenn eine Ausnahme auftritt, wird die aktuelle Position des Streams nicht geändert.

Hinweis

Bestimmen Sie mithilfe der CanWrite-Eigenschaft, ob die aktuelle Instanz Schreibvorgänge unterstützt. Weitere Informationen finden Sie unter CanWrite.

In der folgenden Tabelle sind Beispiele für andere typische oder verwandte E/A-Aufgaben aufgeführt.

Aufgabe	Beispiel in diesem Thema
Erstellen einer Textdatei.	Gewusst wie: Schreiben von Text in eine Datei
In eine Textdatei schreiben.	Gewusst wie: Schreiben von Text in eine Datei
Aus einer Textdatei lesen.	Gewusst wie: Lesen aus einer Textdatei
Text an eine Datei anfügen.	Gewusst wie: Öffnen und Anfügen an eine Protokolldatei File.AppendText FileInfo.AppendText
Eine Datei umbenennen oder verschieben.	File.Move FileInfo.MoveTo
Eine Datei kopieren.	File.Copy FileInfo.CopyTo
Die Größe einer Datei abrufen.	FileInfo.Length
Die Attribute einer Datei abrufen.	File.GetAttributes
Die Attribute einer Datei festlegen.	File.SetAttributes
Bestimmen, ob eine Datei vorhanden ist.	File.Exists
Aus einer Binärdatei lesen.	Gewusst wie: Lesen und Schreiben einer neu erstellten Datendatei
In eine Binärdatei schreiben.	Gewusst wie: Lesen und Schreiben einer neu erstellten Datendatei
Erstellen eines Verzeichnisses.	Directory.CreateDirectory Directory.CreateDirectory

Beispiel

Dieses Codebeispiel ist Teil eines umfangreicheren Beispiels für die Lock-Methode.

' Write the original file data.
If aFileStream.Length = 0 Then
    tempString = _
        lastRecordText + recordNumber.ToString()
    aFileStream.Write(uniEncoding.GetBytes(tempString), _
        0, uniEncoding.GetByteCount(tempString))
End If

// Write the original file data.
if(fileStream.Length == 0)
{
    tempString = 
        lastRecordText + recordNumber.ToString();
    fileStream.Write(uniEncoding.GetBytes(tempString), 
        0, uniEncoding.GetByteCount(tempString));
}

// Write the original file data.
if ( fileStream->Length == 0 )
{
   tempString = String::Concat( lastRecordText, recordNumber.ToString() );
   fileStream->Write( uniEncoding->GetBytes( tempString ), 0, uniEncoding->GetByteCount( tempString ) );
}

// Write the original file data.
if ( fileStream.get_Length() == 0  ) {
    tempString = lastRecordText +(
        new Integer( recordNumber)).ToString();
    fileStream.Write(uniEncoding.GetBytes(tempString),
        0, uniEncoding.GetByteCount(tempString));
}

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

FileStream-Klasse
FileStream-Member
System.IO-Namespace

Weitere Ressourcen

Datei- und Stream-E/A
Gewusst wie: Lesen aus einer Textdatei
Gewusst wie: Schreiben von Text in eine Datei

Freigeben über