Socket.BeginSendFile Metodo

Origine:

Socket.cs

Origine:

Socket.cs

Origine:

Socket.cs

public:
 IAsyncResult ^ BeginSendFile(System::String ^ fileName, AsyncCallback ^ callback, System::Object ^ state);

public IAsyncResult BeginSendFile (string fileName, AsyncCallback? callback, object? state);

public IAsyncResult BeginSendFile (string? fileName, AsyncCallback? callback, object? state);

public IAsyncResult BeginSendFile (string fileName, AsyncCallback callback, object state);

member this.BeginSendFile : string * AsyncCallback * obj -> IAsyncResult

Public Function BeginSendFile (fileName As String, callback As AsyncCallback, state As Object) As IAsyncResult

Parametri

Restituisce

Oggetto IAsyncResult che rappresenta l'invio asincrono.

Eccezioni

Commenti

Questo overload invia il file fileName sul socket. Se si trova nella directory locale, può essere identificato con solo il nome del file. In fileName caso contrario, è necessario specificare il percorso completo e il nome del file. Caratteri jolly (".. \\myfile.txt") e i nomi di condivisione UNC ("\\shared directory\\myfile.txt") sono supportati. Se il file non viene trovato, viene generata l'eccezione FileNotFoundException .

È possibile passare un callback che implementa AsyncCallback a BeginSendFile per ricevere una notifica sul completamento dell'operazione. Si noti che se lo stack di rete sottostante completa l'operazione in modo sincrono, il callback verrà eseguito inline, durante la chiamata a BeginSendFile. In questo caso, la CompletedSynchronously proprietà sul restituito verrà impostata IAsyncResult su per true indicare che il metodo è stato completato in modo sincrono. Utilizzare la AsyncState proprietà dell'oggetto IAsyncResult per ottenere l'oggetto state passato al BeginSendFile metodo .

L'operazione BeginSendFile deve essere completata chiamando il EndSendFile metodo . In genere, il metodo viene richiamato dal AsyncCallback delegato. EndSendFile blocca il thread chiamante fino al completamento dell'operazione.

Anche se destinato ai protocolli orientati alla connessione, funziona anche per i protocolli senza connessione, BeginSendFile purché si chiami prima il Connect metodo o BeginConnect per stabilire un host remoto predefinito. Con protocolli senza connessione, è necessario assicurarsi che le dimensioni del file non superino le dimensioni massime del provider di servizi sottostanti. In caso contrario, il datagram non viene inviato e BeginSendFile genera un'eccezione SocketException .

Origine:

Socket.cs

Origine:

Socket.cs

Origine:

Socket.cs

public:
 IAsyncResult ^ BeginSendFile(System::String ^ fileName, cli::array <System::Byte> ^ preBuffer, cli::array <System::Byte> ^ postBuffer, System::Net::Sockets::TransmitFileOptions flags, AsyncCallback ^ callback, System::Object ^ state);

public IAsyncResult BeginSendFile (string? fileName, byte[]? preBuffer, byte[]? postBuffer, System.Net.Sockets.TransmitFileOptions flags, AsyncCallback? callback, object? state);

public IAsyncResult BeginSendFile (string fileName, byte[] preBuffer, byte[] postBuffer, System.Net.Sockets.TransmitFileOptions flags, AsyncCallback callback, object state);

member this.BeginSendFile : string * byte[] * byte[] * System.Net.Sockets.TransmitFileOptions * AsyncCallback * obj -> IAsyncResult

Public Function BeginSendFile (fileName As String, preBuffer As Byte(), postBuffer As Byte(), flags As TransmitFileOptions, callback As AsyncCallback, state As Object) As IAsyncResult

Parametri

Restituisce

Oggetto IAsyncResult che rappresenta l'operazione asincrona.

Eccezioni

Commenti

Questo overload richiede il nome del file che si vuole inviare e una combinazione bit per bit di TransmitFileOptions valori. Il preBuffer parametro contiene tutti i dati che si desidera precedere il file. postBuffer contiene i dati che si desidera seguire il file. Se si trova nella directory locale, può essere identificato con solo il nome del file. In fileName caso contrario, è necessario specificare il percorso completo e il nome del file. Caratteri jolly (".. \\myfile.txt") e i nomi di condivisione UNC ("\\shared directory\\myfile.txt") sono supportati. Se il file non viene trovato, viene generata l'eccezione FileNotFoundException .

Il flags parametro fornisce informazioni aggiuntive sul trasferimento del file. Per altre informazioni su come usare questo parametro, vedere TransmitFileOptions.

È possibile passare un callback che implementa AsyncCallback a BeginSendFile per ricevere una notifica sul completamento dell'operazione. Si noti che se lo stack di rete sottostante completa l'operazione in modo sincrono, il callback verrà eseguito inline, durante la chiamata a BeginSendFile. In questo caso, la CompletedSynchronously proprietà sul restituito verrà impostata IAsyncResult su per true indicare che il metodo è stato completato in modo sincrono. Utilizzare la AsyncState proprietà dell'oggetto IAsyncResult per ottenere l'oggetto state passato al BeginSendFile metodo .

L'operazione BeginSendFile deve essere completata chiamando il EndSendFile metodo . In genere, il metodo viene richiamato dal delegato fornito AsyncCallback . EndSendFile blocca il thread chiamante fino al completamento dell'operazione.

Anche se destinato ai protocolli orientati alla connessione, funziona anche per i protocolli senza connessione, BeginSendFile purché si chiami prima il Connect metodo o BeginConnect per stabilire un host remoto predefinito. Con protocolli senza connessione, è necessario assicurarsi che le dimensioni del file non superino le dimensioni massime del provider di servizi sottostanti. In caso contrario, il datagram non viene inviato e BeginSendFile genera un'eccezione SocketException .