System.Net.Socket.TSocket.Send

• Übergeordnet: TSocket

Delphi

function Send(const Buf; Count: Integer; Flags: Integer): Integer; overload;
function Send(const Buf; Count: Integer; Flags: TSocketFlags = []): Integer; overload; inline;
function Send(const S: string; Flags: TSocketFlags = []): Integer; overload;
function Send(const B: TBytes; Offset: Integer = 0; Count: Integer = -1; Flags: TSocketFlags = []): Integer; overload;
function Send(const B: array of Byte; Offset: Integer = 0; Count: Integer = -1; Flags: TSocketFlags = []): Integer; overload;

C++

int __fastcall Send(const void *Buf, int Count, int Flags)/* overload */;
int __fastcall Send(const void *Buf, int Count, TSocketFlags Flags = TSocketFlags() )/* overload */;
int __fastcall Send(const System::UnicodeString S, TSocketFlags Flags = TSocketFlags() )/* overload */;
int __fastcall Send(const System::Sysutils::TBytes B, int Offset = 0x0, int Count = 0xffffffff, TSocketFlags Flags = TSocketFlags() )/* overload */;
int __fastcall Send(const System::Byte *B, const System::NativeInt B_High, int Offset = 0x0, int Count = 0xffffffff, TSocketFlags Flags = TSocketFlags() )/* overload */;

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
function	public	System.Net.Socket.pas System.Net.Socket.hpp	System.Net.Socket	TSocket

Beschreibung

Sendet die angegebenen Daten an den verbundenen Endpunkt.

Sie können an Send die folgenden Parameter übergeben:

• Buf ist ein Zeiger auf einen Puffer. der die zu sendenden Daten enthält.
• Offset ist eine Byte-Anzahl, die am Beginn der zu sendenden Daten übersprungen werden soll.
• Count ist die Länge (in Byte) des Puffers, auf den von Buf gezeigt wird. Dies ist zudem die maximale Länge der zu sendenden Daten.
• Flags ist ein Flag-Satz, der das Verhalten von Send beeinflusst. Weitere Informationen finden Sie in der Dokumentation der Funktion send auf der MSDN-Website.

Anstatt einen Zeiger auf einen Puffer (Buf) bereitzustellen, können Sie auch einen String (S) oder ein Byte-Array (B) angeben.

Wenn die angegebenen Daten erfolgreich gesendet wurden, gibt Send die Anzahl der gesendeten Bytes zurück. Wenn Ihr Socket nicht verbunden ist, gibt Send -1 zurück.

Exceptions

Ein Aufruf von Send kann eine der folgenden Exceptions auslösen:

Exception	Exception.Message	Szenarien
ESocketError	Netzwerk-Socket-Fehler: <Fehlermeldung> (<Fehlercode>), bei API 'send'	Das Betriebssystem hat beim beim Senden von Daten über Ihren Socket einen Fehler gemeldet. Weitere Informationen finden Sie in der folgenden Dokumentation für das Betriebssystem, auf dem Ihre Anwendung ausgeführt wurde: Windows: Funktion send (MSDN) OS X: send (OS X Man Pages) iOS: send (iOS Manual Pages) Android: send (Linux Programmer's Manual)
	Socket-Typ nicht kompatibel mit Aufruf	Send kann für einen UDP-Socket nicht verwendet werden. Verwenden Sie stattdessen SendTo, oder ändern sie den Typ Ihres Socket.

Siehe auch

• System.Byte
• System.SysUtils.TBytes
• System.String

• System.Net.Socket.TSocket.BeginSend
• System.Net.Socket.TSocket.EndSend

• System.Net.Socket.TSocket.Accept
• System.Net.Socket.TSocket.Receive

• System.Net.Socket.TSocketStream.Write

• System.Net.Socket.TSocket.SendTo

• Funktion send (MSDN)