UdpSingleSourceMulticastClient.BeginJoinGroup(AsyncCallback, Object) Metodo

Definizione

Spazio dei nomi:

System.Net.Sockets

Assembly:

System.Net.dll

Attenzione

This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.

Associa il socket e inizia un'operazione di join al gruppo multicast per consentire la ricezione dei datagrammi da parte di un indirizzo di origine singolo.

public:
 IAsyncResult ^ BeginJoinGroup(AsyncCallback ^ callback, System::Object ^ state);

[System.Obsolete("This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.", true)]
public IAsyncResult BeginJoinGroup (AsyncCallback callback, object state);

[<System.Obsolete("This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.", true)>]
member this.BeginJoinGroup : AsyncCallback * obj -> IAsyncResult

Public Function BeginJoinGroup (callback As AsyncCallback, state As Object) As IAsyncResult

Parametri

callback

AsyncCallback

Metodo di callback da richiamare al completamento dell'operazione.

state

Object

Informazioni di stato facoltative da passare al metodo callback per l'operazione.

Restituisce

IAsyncResult

IAsyncResult che fa riferimento a questa operazione.

Attributi

ObsoleteAttribute

Eccezioni

InvalidOperationException

Il gruppo multicast è già stato aggiunto o è in corso un'operazione di join.

ObjectDisposedException

L'interfaccia UdpSingleSourceMulticastClient è stata eliminata.

SocketException

Si è verificato un errore durante il tentativo di accesso al socket.

Commenti

Il BeginJoinGroup metodo associa un socket multicast UDP a una porta locale e aggiunge un gruppo multicast per consentire la ricezione di datagrammi da un singolo indirizzo di origine. L'indirizzo del gruppo multicast, l'indirizzo di origine singolo e la porta locale da associare sono specificati nel UdpSingleSourceMulticastClient costruttore.

Il metodo specificato nel callback parametro viene richiamato quando l'operazione di join al gruppo multicast è stata completata.

Se richiesto dal runtime, il BeginJoinGroup metodo esegue anche un controllo dei criteri per verificare che il client sia autorizzato ad accedere al gruppo multicast. Se il client non è consentito l'accesso, viene generato un SocketException oggetto con AccessDenied.