Socket.EndSendFile(IAsyncResult) Metod

Definition

Namnområde:
System.Net.Sockets
Sammansättning:
System.dll
Sammansättning:
netstandard.dll

Avslutar en väntande asynkron sändning av en fil.

public:
 void EndSendFile(IAsyncResult ^ asyncResult);
public void EndSendFile(IAsyncResult asyncResult);
member this.EndSendFile : IAsyncResult -> unit
Public Sub EndSendFile (asyncResult As IAsyncResult)

Parametrar

asyncResult
IAsyncResult

Ett IAsyncResult objekt som lagrar tillståndsinformation för den här asynkrona åtgärden.

Undantag

NotSupportedException

endast .NET 8+ : Socketen är inte ansluten till en fjärrvärd.

ObjectDisposedException

.NET Framework, .NET Core och endast .NET 5–6: Socket har stängts.

ArgumentNullException

asyncResult är tom.

ArgumentException

asyncResult returnerades inte av ett anrop till BeginSendFile(String, AsyncCallback, Object) metoden.

InvalidOperationException

EndSendFile(IAsyncResult) anropades tidigare för den asynkrona BeginSendFile(String, AsyncCallback, Object).

SocketException

Ett fel uppstod vid försök att komma åt socketen.

-eller-

endast .NET 7+ : Socket har stängts.

Kommentarer

Important

Det här är ett kompatibilitets-API. Vi rekommenderar inte att du använder APM-metoderna (Begin* och End*) för ny utveckling. Använd i stället de Task-baserade motsvarigheterna.

EndSendFile slutför åtgärden som startades av BeginSend. Du måste skicka det IAsyncResult som skapats av det matchande BeginSend anropet.

Om du använder ett anslutningslöst protokoll EndSendFile blockerar du tills datagrammet skickas. Om du använder ett anslutningsorienterat protokoll EndSendFile blockerar du tills hela filen skickas. Det finns ingen garanti för att de data du skickar visas i nätverket omedelbart. För att öka nätverkseffektiviteten kan det underliggande systemet fördröja överföringen tills en betydande mängd utgående data samlas in. Ett lyckat slutförande av BeginSendFile metoden innebär att det underliggande systemet har haft utrymme för att buffera dina data för en nätverkssändning.

Note

Om du får en SocketExceptionanvänder du SocketException.ErrorCode egenskapen för att hämta den specifika felkoden. När du har fått den här koden läser du felkoden Windows Sockets version 2 för en detaljerad beskrivning av felet.

Note

Den här medlemmen matar ut spårningsinformation när du aktiverar nätverksspårning i ditt program. Mer information finns i Network Tracing in .NET Framework.

Gäller för