IsolatedStorageFileStream.BeginWrite-Methode

Beginnt einen asynchronen Schreibvorgang.

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

Syntax

'Declaration
Public Overrides Function BeginWrite ( _
    buffer As Byte(), _
    offset As Integer, _
    numBytes As Integer, _
    userCallback As AsyncCallback, _
    stateObject As Object _
) As IAsyncResult
'Usage
Dim instance As IsolatedStorageFileStream
Dim buffer As Byte()
Dim offset As Integer
Dim numBytes As Integer
Dim userCallback As AsyncCallback
Dim stateObject As Object
Dim returnValue As IAsyncResult

returnValue = instance.BeginWrite(buffer, offset, numBytes, userCallback, stateObject)

public override IAsyncResult BeginWrite (
    byte[] buffer,
    int offset,
    int numBytes,
    AsyncCallback userCallback,
    Object stateObject
)

public:
virtual IAsyncResult^ BeginWrite (
    array<unsigned char>^ buffer, 
    int offset, 
    int numBytes, 
    AsyncCallback^ userCallback, 
    Object^ stateObject
) override

public IAsyncResult BeginWrite (
    byte[] buffer, 
    int offset, 
    int numBytes, 
    AsyncCallback userCallback, 
    Object stateObject
)

public override function BeginWrite (
    buffer : byte[], 
    offset : int, 
    numBytes : int, 
    userCallback : AsyncCallback, 
    stateObject : Object
) : IAsyncResult

Parameter

• buffer
  Der Puffer, in den Daten geschrieben werden sollen.

• offset
  Der Byteoffset im buffer, ab dem geschrieben werden soll.

• numBytes
  Die maximale Anzahl der zu schreibenden Bytes.

• userCallback
  Die Methode, die aufgerufen wird, wenn die asynchrone Schreiboperation abgeschlossen ist. Dieser Parameter ist optional.

• stateObject
  Der Status des asynchronen Schreibvorgangs.

Rückgabewert

Eine IAsyncResult-Schnittstelle, die den asynchronen Schreibvorgang darstellt, der möglicherweise noch aussteht. Dieses IAsyncResult muss an die EndWrite-Methode des Streams übergeben werden, um sicherzustellen, dass der Schreibvorgang abgeschlossen ist und die Ressourcen entsprechend freigegeben werden. Sie können dafür den gleichen Code wie für den Aufruf von BeginWrite verwenden oder einen Rückruf an BeginWrite übergeben.

Ausnahmen

Ausnahmetyp	Bedingung
IOException	Es wurde ein asynchroner Schreibvorgang über das Dateiende hinaus versucht.

Hinweise

Wenn ein IsolatedStorageFileStream-Objekt nicht schreibgeschützt ist, wird der Stream durch einen Schreibvorgang am Ende des Streams erweitert.

Die aktuelle Position im Stream wird bei Ausgabe des asynchronen Lese- oder Schreibvorgangs aktualisiert, und nicht nach Abschluss des E/A-Vorgangs.

Rufen Sie die EndWrite-Methode mit dem von dieser Methode zurückgegebenen IAsyncResult-Objekt auf, um zu ermitteln, wie viele Bytes geschrieben wurden.

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

IsolatedStorageFileStream-Klasse
IsolatedStorageFileStream-Member
System.IO.IsolatedStorage-Namespace