UdpClient.Send Yöntem

Başvuru

Tanım

Ad Alanı:: System.Net.Sockets

Bütünleştirilmiş Kod:: System.Net.Sockets.dll

Bütünleştirilmiş Kod:: System.dll

Bütünleştirilmiş Kod:: netstandard.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Uzak bir konağa UDP veri birimi gönderir.

Aşırı Yüklemeler

Send(Byte[], Int32, String, Int32)	Belirtilen uzak konakta belirtilen bağlantı noktasına bir UDP veri birimi gönderir.
Send(ReadOnlySpan<Byte>, String, Int32)	Belirtilen uzak konakta belirtilen bağlantı noktasına bir UDP veri birimi gönderir.
Send(Byte[], Int32, IPEndPoint)	Belirtilen uzak uç noktadaki konağa bir UDP veri birimi gönderir.
Send(Byte[], Int32)	Uzak bir konağa UDP veri birimi gönderir.
Send(ReadOnlySpan<Byte>)	Uzak bir konağa UDP veri birimi gönderir.
Send(ReadOnlySpan<Byte>, IPEndPoint)	Belirtilen uzak uç noktadaki konağa bir UDP veri birimi gönderir.

Send(Byte[], Int32, String, Int32)

Kaynak:: UDPClient.cs

Kaynak:: UDPClient.cs

Kaynak:: UDPClient.cs

Belirtilen uzak konakta belirtilen bağlantı noktasına bir UDP veri birimi gönderir.

public:
 int Send(cli::array <System::Byte> ^ dgram, int bytes, System::String ^ hostname, int port);

public int Send (byte[] dgram, int bytes, string? hostname, int port);

public int Send (byte[] dgram, int bytes, string hostname, int port);

member this.Send : byte[] * int * string * int -> int

Public Function Send (dgram As Byte(), bytes As Integer, hostname As String, port As Integer) As Integer

Parametreler

dgram: Byte[]

Göndermek istediğiniz UDP veri biriminin bayt dizisi olarak temsil edilen bir tür Byte dizisi.

bytes: Int32

Veri birimindeki bayt sayısı.

hostname: String

Veri birimi göndermek istediğiniz uzak konağın adı.

port: Int32

İletişim kurmak istediğiniz uzak bağlantı noktası numarası.

Döndürülenler

Int32

Gönderilen bayt sayısı.

Özel durumlar

ArgumentNullException

dgram, null değeridir.

InvalidOperationException

UdpClient zaten bir varsayılan uzak ana bilgisayar oluşturmuş.

ObjectDisposedException

Kapalı UdpClient .

SocketException

Yuvaya erişilirken bir hata oluştu.

Örnekler

Aşağıdaki örnekte yöntemi gösterilmektedir Send . Bu örnekte, hedef konağı tanımlamak için bir ana bilgisayar adı ve bağlantı noktası numarası kullanılır.

UdpClient^ udpClient = gcnew UdpClient;

array<Byte>^ sendBytes = Encoding::ASCII->GetBytes( "Is anybody there" );
try
{
   udpClient->Send( sendBytes, sendBytes->Length, "www.contoso.com", 11000 );
}
catch ( Exception^ e ) 
{
   Console::WriteLine( e->ToString() );
}

UdpClient udpClient = new UdpClient();

Byte[] sendBytes = Encoding.ASCII.GetBytes("Is anybody there");
try{
    udpClient.Send(sendBytes, sendBytes.Length, "www.contoso.com", 11000);
}
catch ( Exception e ){
    Console.WriteLine(e.ToString());	
}

Dim udpClient As New UdpClient()

Dim sendBytes As [Byte]() = Encoding.ASCII.GetBytes("Is anybody there")
Try
   udpClient.Send(sendBytes, sendBytes.Length, "www.contoso.com", 11000)
Catch e As Exception
   Console.WriteLine(e.ToString())
End Try

Açıklamalar

yöntemi, Send veri birimlerini ve port parametreleri tarafından hostname belirtilen değerlere gönderir ve başarıyla gönderilen bayt sayısını döndürür. Parametre değeri için "255.255.255.255" belirterek veri birimlerini hostname varsayılan yayın adresine gönderebilirsiniz.

Veri birimlerini başka bir yayın adresine göndermek istiyorsanız, temel alınan Socketöğesini almak için yöntemini kullanın Client ve yuva seçeneğini olarak SocketOptionName.Broadcastayarlayın. Sınıfını Socket kullanmaya da geri dönebilirsiniz.

Not

yöntemiyle zaten bir uzak konak oluşturduysanız, bu yönteme bir ana bilgisayar adı veya bağlantı noktası numarası eklemeyin Connect . Bunu yaparsanız, Send yöntemi bir SocketExceptionoluşturur. bir alırsanız, belirli bir SocketExceptionhata kodunu almak için kullanın SocketException.ErrorCode . Bu kodu aldıktan sonra, hatanın ayrıntılı açıklaması için Windows Yuvaları sürüm 2 API hata kodu belgelerine bakabilirsiniz.

Ayrıca bkz.

Şunlara uygulanır

Send(ReadOnlySpan<Byte>, String, Int32)

Kaynak:: UDPClient.cs

Kaynak:: UDPClient.cs

Kaynak:: UDPClient.cs

Belirtilen uzak konakta belirtilen bağlantı noktasına bir UDP veri birimi gönderir.

public:
 int Send(ReadOnlySpan<System::Byte> datagram, System::String ^ hostname, int port);

public int Send (ReadOnlySpan<byte> datagram, string? hostname, int port);

member this.Send : ReadOnlySpan<byte> * string * int -> int

Public Function Send (datagram As ReadOnlySpan(Of Byte), hostname As String, port As Integer) As Integer

Parametreler

datagram: ReadOnlySpan<Byte>

ReadOnlySpan<T> Göndermek istediğiniz UDP veri biriminin belirtildiği TürByte.

hostname: String

Veri birimi göndermek istediğiniz uzak konağın adı.

port: Int32

İletişim kurmak istediğiniz uzak bağlantı noktası numarası.

Döndürülenler

Int32

Gönderilen bayt sayısı.

Özel durumlar

InvalidOperationException

UdpClient zaten bir varsayılan uzak ana bilgisayar oluşturmuş.

ObjectDisposedException

Kapalı UdpClient .

SocketException

Yuvaya erişilirken bir hata oluştu.

Şunlara uygulanır

Send(Byte[], Int32, IPEndPoint)

Kaynak:: UDPClient.cs

Kaynak:: UDPClient.cs

Kaynak:: UDPClient.cs

Belirtilen uzak uç noktadaki konağa bir UDP veri birimi gönderir.

public:
 int Send(cli::array <System::Byte> ^ dgram, int bytes, System::Net::IPEndPoint ^ endPoint);

public int Send (byte[] dgram, int bytes, System.Net.IPEndPoint? endPoint);

public int Send (byte[] dgram, int bytes, System.Net.IPEndPoint endPoint);

member this.Send : byte[] * int * System.Net.IPEndPoint -> int

Public Function Send (dgram As Byte(), bytes As Integer, endPoint As IPEndPoint) As Integer

Parametreler

dgram: Byte[]

Göndermek istediğiniz UDP veri biriminin bayt dizisi olarak gösterildiği tür Byte dizisi.

bytes: Int32

Veri birimindeki bayt sayısı.

endPoint: IPEndPoint

IPEndPoint Veri biriminin gönderildiği konağı ve bağlantı noktasını temsil eden.

Döndürülenler

Int32

Gönderilen bayt sayısı.

Özel durumlar

ArgumentNullException

dgram, null değeridir.

InvalidOperationException

UdpClient zaten bir varsayılan uzak ana bilgisayar kurdu.

ObjectDisposedException

UdpClient kapalıdır.

SocketException

Yuvaya erişilirken bir hata oluştu.

Örnekler

Aşağıdaki örnekte yöntemi gösterilmektedir Send . Bu örnekte hedef konağı belirtmek için bir IPEndPoint kullanılır.

UdpClient^ udpClient = gcnew UdpClient;
IPAddress^ ipAddress = Dns::Resolve( "www.contoso.com" )->AddressList[ 0 ];
IPEndPoint^ ipEndPoint = gcnew IPEndPoint( ipAddress,11004 );

array<Byte>^ sendBytes = Encoding::ASCII->GetBytes( "Is anybody there?" );
try
{
   udpClient->Send( sendBytes, sendBytes->Length, ipEndPoint );
}
catch ( Exception^ e ) 
{
   Console::WriteLine( e->ToString() );
}

UdpClient udpClient = new UdpClient();
IPAddress ipAddress = Dns.Resolve("www.contoso.com").AddressList[0];
IPEndPoint ipEndPoint = new IPEndPoint(ipAddress, 11004);	

Byte[] sendBytes = Encoding.ASCII.GetBytes("Is anybody there?");
try{
    udpClient.Send(sendBytes, sendBytes.Length, ipEndPoint);
}
catch ( Exception e ){
    Console.WriteLine(e.ToString());	
}

Dim udpClient As New UdpClient()
Dim ipAddress As IPAddress = Dns.Resolve("www.contoso.com").AddressList(0)
Dim ipEndPoint As New IPEndPoint(ipAddress, 11004)

Dim sendBytes As [Byte]() = Encoding.ASCII.GetBytes("Is anybody there?")
Try
   udpClient.Send(sendBytes, sendBytes.Length, ipEndPoint)
Catch e As Exception
   Console.WriteLine(e.ToString())
End Try

Açıklamalar

yöntemi belirtilen Send uç noktaya veri birimleri gönderir ve başarıyla gönderilen bayt sayısını döndürür. Bu aşırı yüklemeyi çağırmadan önce, veri birimlerinizin teslim edeceği uzak konağın IP adresini ve bağlantı noktası numarasını kullanarak bir IPEndPoint oluşturmanız gerekir. özelliğini IPEndPointbelirterek SocketOptionName.Broadcast Address veri birimlerini varsayılan yayın adresine (255.255.255.255)gönderebilirsiniz. Bunu IPEndPointoluşturduktan sonra parametresi olarak yöntemine SendendPoint geçirin.

Not

yöntemiyle zaten bir endPoint uzak konak oluşturduysanız bu yönteme parametre sağlamayın Connect . Bunu yaparsanız, Send yöntemi bir SocketExceptionoluşturur. bir alırsanız, belirli bir SocketExceptionhata kodunu almak için kullanın SocketException.ErrorCode . Bu kodu aldıktan sonra, hatanın ayrıntılı açıklaması için Windows Yuvaları sürüm 2 API hata kodu belgelerine bakabilirsiniz.

Ayrıca bkz.

Şunlara uygulanır

Send(Byte[], Int32)

Kaynak:: UDPClient.cs

Kaynak:: UDPClient.cs

Kaynak:: UDPClient.cs

Uzak bir konağa UDP veri birimi gönderir.

public:
 int Send(cli::array <System::Byte> ^ dgram, int bytes);

public int Send (byte[] dgram, int bytes);

member this.Send : byte[] * int -> int

Public Function Send (dgram As Byte(), bytes As Integer) As Integer

Parametreler

dgram: Byte[]

Göndermek istediğiniz UDP veri biriminin bayt dizisi olarak temsil edilen bir tür Byte dizisi.

bytes: Int32

Veri birimindeki bayt sayısı.

Döndürülenler

Int32

Gönderilen bayt sayısı.

Özel durumlar

ArgumentNullException

dgram, null değeridir.

InvalidOperationException

UdpClient zaten bir varsayılan uzak ana bilgisayar oluşturmuş.

ObjectDisposedException

Kapalı UdpClient .

SocketException

Yuvaya erişilirken bir hata oluştu.

Örnekler

Aşağıdaki örnekte yöntemi gösterilmektedir Send . Bu aşırı yüklemeyi kullanmadan önce varsayılan bir uzak konak oluşturmanız gerekir.

UdpClient^ udpClient = gcnew UdpClient( "www.contoso.com",11000 );
array<Byte>^ sendBytes = Encoding::ASCII->GetBytes( "Is anybody there" );
try
{
   udpClient->Send( sendBytes, sendBytes->Length );
}
catch ( Exception^ e ) 
{
   Console::WriteLine( e->ToString() );
}

UdpClient udpClient = new UdpClient("www.contoso.com", 11000);
Byte[] sendBytes = Encoding.ASCII.GetBytes("Is anybody there");
try{
    udpClient.Send(sendBytes, sendBytes.Length);
}
catch ( Exception e ){
    Console.WriteLine( e.ToString());
}

Dim udpClient As New UdpClient("www.contoso.com", 11000)
Dim sendBytes As [Byte]() = Encoding.ASCII.GetBytes("Is anybody there")
Try
   udpClient.Send(sendBytes, sendBytes.Length)
Catch e As Exception
   Console.WriteLine(e.ToString())
End Try

Açıklamalar

Bu aşırı yükleme yönteminde Connect oluşturulan uzak konağa veri birimleri gönderir ve gönderilen bayt sayısını döndürür. Bu aşırı yüklemeyi çağırmadan önce çağırmazsanız Connect , Send yöntemi bir SocketExceptionoluşturur. bir alırsanız, belirli bir SocketExceptionhata kodunu almak için kullanın SocketException.ErrorCode . Bu kodu aldıktan sonra, hatanın ayrıntılı açıklaması için Windows Yuvaları sürüm 2 API hata kodu belgelerine bakabilirsiniz.

Veri birimlerini farklı bir uzak konağa göndermek istiyorsanız yöntemini çağırmanız Connect ve istenen uzak konağı belirtmeniz gerekir. Veri birimlerini bir yayın adresine göndermek için diğer Send yöntem aşırı yüklemelerinden birini kullanın.

Ayrıca bkz.

Connect(String, Int32)

Şunlara uygulanır

Send(ReadOnlySpan<Byte>)

Kaynak:: UDPClient.cs

Kaynak:: UDPClient.cs

Kaynak:: UDPClient.cs

Uzak bir konağa UDP veri birimi gönderir.

public:
 int Send(ReadOnlySpan<System::Byte> datagram);

public int Send (ReadOnlySpan<byte> datagram);

member this.Send : ReadOnlySpan<byte> -> int

Public Function Send (datagram As ReadOnlySpan(Of Byte)) As Integer

Parametreler

datagram: ReadOnlySpan<Byte>

ReadOnlySpan<T> Göndermek istediğiniz UDP veri biriminin belirtildiği TürByte.

Döndürülenler

Int32

Gönderilen bayt sayısı.

Özel durumlar

InvalidOperationException

varsayılan UdpClient uzak ana bilgisayar oluşturmadı.

ObjectDisposedException

Kapalı UdpClient .

SocketException

Yuvaya erişilirken bir hata oluştu.

Şunlara uygulanır

Send(ReadOnlySpan<Byte>, IPEndPoint)

Kaynak:: UDPClient.cs

Kaynak:: UDPClient.cs

Kaynak:: UDPClient.cs

Belirtilen uzak uç noktadaki konağa bir UDP veri birimi gönderir.

public:
 int Send(ReadOnlySpan<System::Byte> datagram, System::Net::IPEndPoint ^ endPoint);

public int Send (ReadOnlySpan<byte> datagram, System.Net.IPEndPoint? endPoint);

member this.Send : ReadOnlySpan<byte> * System.Net.IPEndPoint -> int

Public Function Send (datagram As ReadOnlySpan(Of Byte), endPoint As IPEndPoint) As Integer

Parametreler

datagram: ReadOnlySpan<Byte>

ReadOnlySpan<T> Göndermek istediğiniz UDP veri biriminin belirtildiği TürByte.

endPoint: IPEndPoint

IPEndPoint Veri biriminin gönderildiği konağı ve bağlantı noktasını temsil eden.

Döndürülenler

Int32

Gönderilen bayt sayısı.

Özel durumlar

InvalidOperationException

UdpClient zaten bir varsayılan uzak ana bilgisayar oluşturdu ve endPoint değil null.

ObjectDisposedException

UdpClient kapalıdır.

SocketException

Yuvaya erişilirken bir hata oluştu.

Şunlara uygulanır

Aracılığıyla paylaş

UdpClient.Send Yöntem

Tanım

Aşırı Yüklemeler

Send(Byte[], Int32, String, Int32)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Send(ReadOnlySpan<Byte>, String, Int32)

Parametreler

Döndürülenler

Özel durumlar

Şunlara uygulanır

Send(Byte[], Int32, IPEndPoint)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Send(Byte[], Int32)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Send(ReadOnlySpan<Byte>)

Parametreler

Döndürülenler

Özel durumlar

Şunlara uygulanır

Send(ReadOnlySpan<Byte>, IPEndPoint)

Parametreler

Döndürülenler

Özel durumlar

Şunlara uygulanır

Ek kaynaklar