MulticastOption Klass
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Innehåller IPAddress värden som används för att koppla och släppa multicast-grupper.
public ref class MulticastOption
public class MulticastOption
type MulticastOption = class
Public Class MulticastOption
- Arv
-
MulticastOption
Exempel
Följande exempel ansluter standard-IP-gränssnittet till en IP-multicast-grupp. De antar ip-multicast-gruppadressen i intervallet 224.0.0.0 till 239.255.255.255.
using System;
using System.Net;
using System.Net.Sockets;
using System.Text;
// This is the listener example that shows how to use the MulticastOption class.
// In particular, it shows how to use the MulticastOption(IPAddress, IPAddress)
// constructor, which you need to use if you have a host with more than one
// network card.
// The first parameter specifies the multicast group address, and the second
// specifies the local address of the network card you want to use for the data
// exchange.
// You must run this program in conjunction with the sender program as
// follows:
// Open a console window and run the listener from the command line.
// In another console window run the sender. In both cases you must specify
// the local IPAddress to use. To obtain this address run the ipconfig command
// from the command line.
//
namespace Mssc.TransportProtocols.Utilities
{
public class TestMulticastOption
{
private static IPAddress s_mcastAddress;
private static int s_mcastPort;
private static Socket s_mcastSocket;
private static MulticastOption s_mcastOption;
private static void MulticastOptionProperties()
{
Console.WriteLine("Current multicast group is: " + s_mcastOption.Group);
Console.WriteLine("Current multicast local address is: " + s_mcastOption.LocalAddress);
}
private static void StartMulticast()
{
try
{
s_mcastSocket = new Socket(AddressFamily.InterNetwork,
SocketType.Dgram,
ProtocolType.Udp);
Console.Write("Enter the local IP address: ");
IPAddress localIPAddr = IPAddress.Parse(Console.ReadLine());
//IPAddress localIP = IPAddress.Any;
EndPoint localEP = (EndPoint)new IPEndPoint(localIPAddr, s_mcastPort);
s_mcastSocket.Bind(localEP);
// Define a MulticastOption object specifying the multicast group
// address and the local IPAddress.
// The multicast group address is the same as the address used by the server.
s_mcastOption = new MulticastOption(s_mcastAddress, localIPAddr);
s_mcastSocket.SetSocketOption(SocketOptionLevel.IP,
SocketOptionName.AddMembership,
s_mcastOption);
}
catch (Exception e)
{
Console.WriteLine(e.ToString());
}
}
private static void ReceiveBroadcastMessages()
{
bool done = false;
byte[] bytes = new byte[100];
IPEndPoint groupEP = new(s_mcastAddress, s_mcastPort);
EndPoint remoteEP = (EndPoint)new IPEndPoint(IPAddress.Any, 0);
try
{
while (!done)
{
Console.WriteLine("Waiting for multicast packets.......");
Console.WriteLine("Enter ^C to terminate.");
s_mcastSocket.ReceiveFrom(bytes, ref remoteEP);
Console.WriteLine("Received broadcast from {0} :\n {1}\n",
groupEP.ToString(),
Encoding.ASCII.GetString(bytes, 0, bytes.Length));
}
s_mcastSocket.Close();
}
catch (Exception e)
{
Console.WriteLine(e.ToString());
}
}
public static void Main(string[] args)
{
// Initialize the multicast address group and multicast port.
// Both address and port are selected from the allowed sets as
// defined in the related RFC documents. These are the same
// as the values used by the sender.
s_mcastAddress = IPAddress.Parse("224.168.100.2");
s_mcastPort = 11000;
// Start a multicast group.
StartMulticast();
// Display MulticastOption properties.
MulticastOptionProperties();
// Receive broadcast messages.
ReceiveBroadcastMessages();
}
}
}
' This is the listener example that shows how to use the MulticastOption class.
' In particular, it shows how to use the MulticastOption(IPAddress, IPAddress)
' constructor, which you need to use if you have a host with more than one
' network card.
' The first parameter specifies the multicast group address, and the second
' specifies the local address of the network card you want to use for the data
' exchange.
' You must run this program in conjunction with the sender program as
' follows:
' Open a console window and run the listener from the command line.
' In another console window run the sender. In both cases you must specify
' the local IPAddress to use. To obtain this address run the ipconfig command
' from the command line.
Imports System.Net
Imports System.Net.Sockets
Imports System.Text
Namespace Mssc.TransportProtocols.Utilities
Module M_TestMulticastOption
Public Class TestMulticastOption
Private Shared mcastAddress As IPAddress
Private Shared mcastPort As Integer
Private Shared mcastSocket As Socket
Private Shared mcastOption As MulticastOption
Private Shared Sub MulticastOptionProperties()
Console.WriteLine(("Current multicast group is: " + mcastOption.Group.ToString()))
Console.WriteLine(("Current multicast local address is: " + mcastOption.LocalAddress.ToString()))
End Sub
Private Shared Sub StartMulticast()
Try
mcastSocket = New Socket(AddressFamily.InterNetwork, SocketType.Dgram, ProtocolType.Udp)
Console.Write("Enter the local IP address: ")
Dim localIPAddr As IPAddress = IPAddress.Parse(Console.ReadLine())
'IPAddress localIP = IPAddress.Any;
Dim localEP As EndPoint = CType(New IPEndPoint(localIPAddr, mcastPort), EndPoint)
mcastSocket.Bind(localEP)
' Define a MulticastOption object specifying the multicast group
' address and the local IPAddress.
' The multicast group address is the same as the address used by the server.
mcastOption = New MulticastOption(mcastAddress, localIPAddr)
mcastSocket.SetSocketOption(SocketOptionLevel.IP, SocketOptionName.AddMembership, mcastOption)
Catch e As Exception
Console.WriteLine(e.ToString())
End Try
End Sub
Private Shared Sub ReceiveBroadcastMessages()
Dim done As Boolean = False
Dim bytes() As Byte = New [Byte](99) {}
Dim groupEP As New IPEndPoint(mcastAddress, mcastPort)
Dim remoteEP As EndPoint = CType(New IPEndPoint(IPAddress.Any, 0), EndPoint)
Try
While Not done
Console.WriteLine("Waiting for multicast packets.......")
Console.WriteLine("Enter ^C to terminate.")
mcastSocket.ReceiveFrom(bytes, remoteEP)
Console.WriteLine("Received broadcast from {0} :" + ControlChars.Lf + " {1}" + ControlChars.Lf, groupEP.ToString(), Encoding.ASCII.GetString(bytes, 0, bytes.Length))
End While
mcastSocket.Close()
Catch e As Exception
Console.WriteLine(e.ToString())
End Try
End Sub
Public Shared Sub Main(ByVal args() As String)
' Initialize the multicast address group and multicast port.
' Both address and port are selected from the allowed sets as
' defined in the related RFC documents. These are the same
' as the values used by the sender.
mcastAddress = IPAddress.Parse("224.168.100.2")
mcastPort = 11000
' Start a multicast group.
StartMulticast()
' Display MulticastOption properties.
MulticastOptionProperties()
' Receive broadcast messages.
ReceiveBroadcastMessages()
End Sub
End Class
End Module
End Namespace
using System;
using System.Net.Sockets;
using System.Net;
using System.Text;
// This sender example must be used in conjunction with the listener program.
// You must run this program as follows:
// Open a console window and run the listener from the command line.
// In another console window run the sender. In both cases you must specify
// the local IPAddress to use. To obtain this address, run the ipconfig command
// from the command line.
//
namespace Mssc.TransportProtocols.Utilities
{
class TestMulticastOption2
{
static IPAddress s_mcastAddress;
static int s_mcastPort;
static Socket s_mcastSocket;
static void JoinMulticastGroup()
{
try
{
// Create a multicast socket.
s_mcastSocket = new Socket(AddressFamily.InterNetwork,
SocketType.Dgram,
ProtocolType.Udp);
// Get the local IP address used by the listener and the sender to
// exchange multicast messages.
Console.Write("\nEnter local IPAddress for sending multicast packets: ");
IPAddress localIPAddr = IPAddress.Parse(Console.ReadLine());
// Create an IPEndPoint object.
IPEndPoint IPlocal = new IPEndPoint(localIPAddr, 0);
// Bind this endpoint to the multicast socket.
s_mcastSocket.Bind(IPlocal);
// Define a MulticastOption object specifying the multicast group
// address and the local IP address.
// The multicast group address is the same as the address used by the listener.
MulticastOption mcastOption;
mcastOption = new MulticastOption(s_mcastAddress, localIPAddr);
s_mcastSocket.SetSocketOption(SocketOptionLevel.IP,
SocketOptionName.AddMembership,
mcastOption);
}
catch (Exception e)
{
Console.WriteLine("\n" + e.ToString());
}
}
static void BroadcastMessage(string message)
{
IPEndPoint endPoint;
try
{
//Send multicast packets to the listener.
endPoint = new IPEndPoint(s_mcastAddress, s_mcastPort);
s_mcastSocket.SendTo(ASCIIEncoding.ASCII.GetBytes(message), endPoint);
Console.WriteLine("Multicast data sent.....");
}
catch (Exception e)
{
Console.WriteLine("\n" + e.ToString());
}
s_mcastSocket.Close();
}
static void Main(string[] args)
{
// Initialize the multicast address group and multicast port.
// Both address and port are selected from the allowed sets as
// defined in the related RFC documents. These are the same
// as the values used by the sender.
s_mcastAddress = IPAddress.Parse("224.168.100.2");
s_mcastPort = 11000;
// Join the listener multicast group.
JoinMulticastGroup();
// Broadcast the message to the listener.
BroadcastMessage("Hello multicast listener.");
}
}
}
' This sender example must be used in conjunction with the listener program.
' You must run this program as follows:
' Open a console window and run the listener from the command line.
' In another console window run the sender. In both cases you must specify
' the local IPAddress to use. To obtain this address, run the ipconfig command
' from the command line.
'
Imports System.Net.Sockets
Imports System.Net
Imports System.Text
Namespace Mssc.TransportProtocols.Utilities
Module M_TestMulticastOption
Class TestMulticastOption
Private Shared mcastAddress As IPAddress
Private Shared mcastPort As Integer
Private Shared mcastSocket As Socket
Shared Sub JoinMulticastGroup()
Try
' Create a multicast socket.
mcastSocket = New Socket(AddressFamily.InterNetwork, SocketType.Dgram, ProtocolType.Udp)
' Get the local IP address used by the listener and the sender to
' exchange multicast messages.
Console.Write(ControlChars.Lf + "Enter local IPAddress for sending multicast packets: ")
Dim localIPAddr As IPAddress = IPAddress.Parse(Console.ReadLine())
' Create an IPEndPoint object.
Dim IPlocal As New IPEndPoint(localIPAddr, 0)
' Bind this endpoint to the multicast socket.
mcastSocket.Bind(IPlocal)
' Define a MulticastOption object specifying the multicast group
' address and the local IP address.
' The multicast group address is the same as the address used by the listener.
Dim mcastOption As MulticastOption
mcastOption = New MulticastOption(mcastAddress, localIPAddr)
mcastSocket.SetSocketOption(SocketOptionLevel.IP, SocketOptionName.AddMembership, mcastOption)
Catch e As Exception
Console.WriteLine((ControlChars.Lf + e.ToString()))
End Try
End Sub
Shared Sub BroadcastMessage(ByVal message As String)
Dim endPoint As IPEndPoint
Try
'Send multicast packets to the listener.
endPoint = New IPEndPoint(mcastAddress, mcastPort)
mcastSocket.SendTo(ASCIIEncoding.ASCII.GetBytes(message), endPoint)
Console.WriteLine("Multicast data sent.....")
Catch e As Exception
Console.WriteLine((ControlChars.Lf + e.ToString()))
End Try
mcastSocket.Close()
End Sub
Public Shared Sub Main(ByVal args() As String)
' Initialize the multicast address group and multicast port.
' Both address and port are selected from the allowed sets as
' defined in the related RFC documents. These are the same as the
' values used by the sender.
mcastAddress = IPAddress.Parse("224.168.100.2")
mcastPort = 11000
' Join the listener multicast group.
JoinMulticastGroup()
' Broadcast the message to the listener.
BroadcastMessage("Hello multicast listener.")
End Sub
End Class
End Module
End Namespace
Kommentarer
Använd en MulticastOption för att lagra den IPAddress för en multicast-grupp som du vill ansluta till eller släppa. Socket.SetSocketOption Använd metoden med följande parametrar för att ansluta till en multicast-grupp.
| Parameter | Value |
|---|---|
| socketOptionLevel | SocketOptionLevel.Udp |
| socketOptionName | AddMembership |
| object | MulticastOption |
Använd DropMembership för att släppa en multicast-grupp.
Konstruktorer
| Name | Description |
|---|---|
| MulticastOption(IPAddress, Int32) |
Initierar en ny instans av MulticastOption klassen med angiven IP-multicast-gruppadress och gränssnittsindex. |
| MulticastOption(IPAddress, IPAddress) |
Initierar en ny instans av MulticastOption klassen med den angivna IP-multicast-gruppadressen och den lokala IP-adressen som är associerad med ett nätverksgränssnitt. |
| MulticastOption(IPAddress) |
Initierar en ny version av MulticastOption klassen för den angivna IP-multicast-gruppen. |
Egenskaper
| Name | Description |
|---|---|
| Group |
Hämtar eller anger IP-adressen för en multicast-grupp. |
| InterfaceIndex |
Hämtar eller anger indexet för gränssnittet som används för att skicka och ta emot multicast-paket. |
| LocalAddress |
Hämtar eller anger den lokala adressen som är associerad med en multicast-grupp. |
Metoder
| Name | Description |
|---|---|
| Equals(Object) |
Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object) |
| GetHashCode() |
Fungerar som standard-hash-funktion. (Ärvd från Object) |
| GetType() |
Hämtar den aktuella instansen Type . (Ärvd från Object) |
| MemberwiseClone() |
Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object) |
| ToString() |
Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object) |