BufferedStream.Write-Methode

Kopiert Bytes in den gepufferten Stream und verschiebt die aktuelle Position im gepufferten Stream um die Anzahl der geschriebenen Bytes.

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 BufferedStream
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
  Das Bytearray, aus dem count Bytes in den aktuellen gepufferten Stream kopiert werden sollen.

• offset
  Der Offset im Puffer, ab dem Bytes in den aktuellen gepufferten Stream kopiert werden sollen.

• count
  Die Anzahl der Bytes, die in den aktuellen gepufferten Stream geschrieben werden sollen.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentException	Die Länge von array minus offset ist kleiner als count.
ArgumentNullException	array ist NULL (Nothing in Visual Basic).
ArgumentOutOfRangeException	offset oder count ist negativ.
IOException	Der Stream ist geschlossen oder NULL (Nothing in Visual Basic).
NotSupportedException	Der Stream unterstützt keine Schreibvorgänge.
ObjectDisposedException	Es wurden Methoden aufgerufen, nachdem der Stream geschlossen wurde.

Hinweise

Ein Beispiel für das Erstellen einer Datei und das Schreiben von Text in eine Datei finden Sie unter Gewusst wie: Schreiben von Text in eine Datei. Ein Beispiel für das Lesen von Text aus einer Datei finden Sie unter Gewusst wie: Lesen aus einer Textdatei. Ein Beispiel für das Lesen aus einer Binärdatei und das Schreiben in eine Binärdatei finden Sie unter Gewusst wie: Lesen und Schreiben einer neu erstellten Datendatei.

Beispiel

Dieses Codebeispiel ist Teil eines umfangreicheren Beispiels für die BufferedStream-Klasse.

' Send the data using the BufferedStream.
Console.WriteLine("Sending data using BufferedStream.")
startTime = DateTime.Now
For i As Integer = 1 To numberOfLoops
    bufStream.Write(dataToSend, 0, dataToSend.Length)
Next i

bufStream.Flush()
bufferedTime = DateTime.Now.Subtract(startTime).TotalSeconds
Console.WriteLine("{0} bytes sent In {1} seconds." & vbCrLf, _
    numberOfLoops * dataToSend.Length, _
    bufferedTime.ToString("F1"))

// Send the data using the BufferedStream.
Console.WriteLine("Sending data using BufferedStream.");
startTime = DateTime.Now;
for(int i = 0; i < numberOfLoops; i++)
{
    bufStream.Write(dataToSend, 0, dataToSend.Length);
}
bufStream.Flush();
bufferedTime = (DateTime.Now - startTime).TotalSeconds;
Console.WriteLine("{0} bytes sent in {1} seconds.\n",
    numberOfLoops * dataToSend.Length, 
    bufferedTime.ToString("F1"));

// Send the data using the BufferedStream.
Console::WriteLine( "Sending data using BufferedStream." );
startTime = DateTime::Now;
for ( int i = 0; i < numberOfLoops; i++ )
{
   bufStream->Write( dataToSend, 0, dataToSend->Length );

}
bufStream->Flush();
bufferedTime = (DateTime::Now - startTime).TotalSeconds;
Console::WriteLine( "{0} bytes sent in {1} seconds.\n", (numberOfLoops * dataToSend->Length).ToString(), bufferedTime.ToString(  "F1" ) );

// Send the data using the BufferedStream.
Console.WriteLine("Sending data using BufferedStream.");
startTime = DateTime.get_Now();
for(int i=0;i < numberOfLoops;i++) {
    bufStream.Write(dataToSend, 0, dataToSend.length);
}        
bufStream.Flush();
bufferedTime = 
    ((DateTime.get_Now()).Subtract(startTime)).get_TotalSeconds();
Console.WriteLine("{0} bytes sent in {1} seconds.\n",
    System.Convert.ToString (numberOfLoops * dataToSend.length),
    ((System.Double)bufferedTime).ToString("F1"));

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

Siehe auch

Referenz

BufferedStream-Klasse
BufferedStream-Member
System.IO-Namespace
CanWrite
Read

Weitere Ressourcen

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