UdpClient Konstruktorer
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.
Initierar en ny instans av UdpClient klassen.
Överlagringar
| Name | Description |
|---|---|
| UdpClient() |
Initierar en ny instans av UdpClient klassen. |
| UdpClient(Int32) |
Initierar en ny instans av UdpClient klassen och binder den till det lokala portnummer som anges. |
| UdpClient(IPEndPoint) |
Initierar en ny instans av UdpClient klassen och binder den till den angivna lokala slutpunkten. |
| UdpClient(AddressFamily) |
Initierar en ny instans av UdpClient klassen. |
| UdpClient(Int32, AddressFamily) |
Initierar en ny instans av UdpClient klassen och binder den till det lokala portnummer som anges. |
| UdpClient(String, Int32) |
Initierar en ny instans av UdpClient klassen och etablerar en fjärrvärd som standard. |
UdpClient()
- Källa:
- UDPClient.cs
- Källa:
- UDPClient.cs
- Källa:
- UDPClient.cs
- Källa:
- UDPClient.cs
- Källa:
- UDPClient.cs
Initierar en ny instans av UdpClient klassen.
public:
UdpClient();
public UdpClient();
Public Sub New ()
Undantag
Ett fel uppstod vid åtkomst till socketen.
Exempel
I följande exempel visas hur du använder den parameterlösa konstruktorn för att skapa en instans av UdpClient klassen.
//Creates an instance of the UdpClient class using the default constructor.
UdpClient udpClient = new UdpClient();
'Creates an instance of the UdpClient class using the default constructor.
Dim udpClient As New UdpClient()
Kommentarer
Den här konstruktorn skapar en ny UdpClient och gör att den underliggande tjänstleverantören kan tilldela den lämpligaste lokala IPv4-adressen och portnumret. Om den här konstruktorn används anges instansen UdpClient med en adressfamilj med IPv4 som inte kan ändras eller skrivas över av ett anslutningsmetodanrop med ett IPv6-mål.
Note
Om du får en SocketExceptionanvänder SocketException.ErrorCode du för att hämta den specifika felkoden. När du har fått den här koden kan du läsa felkoden Windows Sockets version 2 API för en detaljerad beskrivning av felet.
Den här konstruktorn är inte lämplig för anslutning till en multicast-grupp eftersom den inte utför socketbindning. Dessutom fungerar den bara med IPv4-adresstyper.
Gäller för
UdpClient(Int32)
- Källa:
- UDPClient.cs
- Källa:
- UDPClient.cs
- Källa:
- UDPClient.cs
- Källa:
- UDPClient.cs
- Källa:
- UDPClient.cs
Initierar en ny instans av UdpClient klassen och binder den till det lokala portnummer som anges.
public:
UdpClient(int port);
public UdpClient(int port);
new System.Net.Sockets.UdpClient : int -> System.Net.Sockets.UdpClient
Public Sub New (port As Integer)
Parametrar
- port
- Int32
Det lokala portnummer som du tänker kommunicera med.
Undantag
Ett fel uppstod vid åtkomst till socketen.
Exempel
I följande exempel visas hur du använder ett lokalt portnummer för att skapa en instans av UdpClient klassen.
//Creates an instance of the UdpClient class to listen on
// the default interface using a particular port.
try{
UdpClient udpClient = new UdpClient(11000);
}
catch (Exception e ) {
Console.WriteLine(e.ToString());
}
'Creates an instance of the UdpClient class to listen on
'the default interface using a particular port.
Try
Dim udpClient As New UdpClient(11000)
Catch e As Exception
Console.WriteLine(e.ToString())
End Try
Kommentarer
Den här konstruktorn skapar en underliggande Socket och binder den till det portnummer som du tänker kommunicera från. Använd den här konstruktorn om du bara är intresserad av att ange det lokala portnumret. Den underliggande tjänstleverantören tilldelar den lokala IP-adressen. Om du skickar 0 till konstruktorn tilldelar den underliggande tjänstleverantören ett portnummer. Om den här konstruktorn används anges instansen UdpClient med en adressfamilj med IPv4 som inte kan ändras eller skrivas över av ett anslutningsmetodanrop med ett IPv6-mål.
Note
Om du får en SocketExceptionanvänder SocketException.ErrorCode du för att hämta den specifika felkoden. När du har fått den här koden kan du läsa felkoden Windows Sockets version 2 API för en detaljerad beskrivning av felet.
Den här konstruktorn fungerar endast med IPv4-adresstyper.
Gäller för
UdpClient(IPEndPoint)
- Källa:
- UDPClient.cs
- Källa:
- UDPClient.cs
- Källa:
- UDPClient.cs
- Källa:
- UDPClient.cs
- Källa:
- UDPClient.cs
Initierar en ny instans av UdpClient klassen och binder den till den angivna lokala slutpunkten.
public:
UdpClient(System::Net::IPEndPoint ^ localEP);
public UdpClient(System.Net.IPEndPoint localEP);
new System.Net.Sockets.UdpClient : System.Net.IPEndPoint -> System.Net.Sockets.UdpClient
Public Sub New (localEP As IPEndPoint)
Parametrar
- localEP
- IPEndPoint
En IPEndPoint som representerar den lokala slutpunkt som du binder UDP-anslutningen till.
Undantag
localEP är null.
Ett fel uppstod vid åtkomst till socketen.
Exempel
I följande exempel visas hur du skapar en instans av klassen med hjälp av UdpClient en lokal slutpunkt.
//Creates an instance of the UdpClient class using a local endpoint.
IPAddress ipAddress = Dns.Resolve(Dns.GetHostName()).AddressList[0];
IPEndPoint ipLocalEndPoint = new IPEndPoint(ipAddress, 11000);
try{
UdpClient udpClient = new UdpClient(ipLocalEndPoint);
}
catch (Exception e ) {
Console.WriteLine(e.ToString());
}
'Creates an instance of the UdpClient class using a local endpoint.
Dim ipAddress As IPAddress = Dns.Resolve(Dns.GetHostName()).AddressList(0)
Dim ipLocalEndPoint As New IPEndPoint(ipAddress, 11000)
Try
Dim udpClient As New UdpClient(ipLocalEndPoint)
Catch e As Exception
Console.WriteLine(e.ToString())
End Try
Kommentarer
Konstruktorn skapar en ny UdpClient och binder den till den IPEndPoint som anges av parametern localEP . Innan du anropar den här konstruktorn måste du skapa en IPEndPoint med ip-adressen och portnumret som du tänker skicka och ta emot data från. Du behöver inte ange en lokal IP-adress och ett portnummer för att skicka och ta emot data. Om du inte gör det tilldelar den underliggande tjänstleverantören den lämpligaste lokala IP-adressen och portnumret.
Om den här konstruktorn används anges instansen UdpClient med den adressfamilj som anges av parametern localEP som inte kan ändras eller skrivas över av ett anslutningsmetodanrop med en annan adressfamilj.
Note
Om du får en SocketExceptionanvänder SocketException.ErrorCode du för att hämta den specifika felkoden. När du har fått den här koden kan du läsa felkoden Windows Sockets version 2 API för en detaljerad beskrivning av felet.
Se även
Gäller för
UdpClient(AddressFamily)
- Källa:
- UDPClient.cs
- Källa:
- UDPClient.cs
- Källa:
- UDPClient.cs
- Källa:
- UDPClient.cs
- Källa:
- UDPClient.cs
Initierar en ny instans av UdpClient klassen.
public:
UdpClient(System::Net::Sockets::AddressFamily family);
public UdpClient(System.Net.Sockets.AddressFamily family);
new System.Net.Sockets.UdpClient : System.Net.Sockets.AddressFamily -> System.Net.Sockets.UdpClient
Public Sub New (family As AddressFamily)
Parametrar
- family
- AddressFamily
Ett av de AddressFamily värden som anger socketens adressschema.
Undantag
family är inte InterNetwork eller InterNetworkV6.
Ett fel uppstod vid åtkomst till socketen.
Kommentarer
Parametern family avgör om lyssnaren använder en IP-version 4-adress (IPv4) eller en IP-version 6-adress (IPv6). Om du vill använda en IPv4-adress skickar du InterNetwork värdet. Om du vill använda en IPv6-adress skickar du InterNetworkV6 värdet. Om du skickar ett annat värde genereras en ArgumentException.
Om den här konstruktorn används anges instansen UdpClient med den adressfamilj som anges av parametern family som inte kan ändras eller skrivas över av ett anslutningsmetodanrop med en annan adressfamilj.
Note
Om du får en SocketExceptionanvänder SocketException.ErrorCode du för att hämta den specifika felkoden. När du har fått den här koden kan du läsa felkoden Windows Sockets version 2 API för en detaljerad beskrivning av felet.
Lämpar UdpClient.UdpClient(AddressFamily) sig inte för anslutning till en multicast-grupp eftersom den inte utför socketbindning.
Gäller för
UdpClient(Int32, AddressFamily)
- Källa:
- UDPClient.cs
- Källa:
- UDPClient.cs
- Källa:
- UDPClient.cs
- Källa:
- UDPClient.cs
- Källa:
- UDPClient.cs
Initierar en ny instans av UdpClient klassen och binder den till det lokala portnummer som anges.
public:
UdpClient(int port, System::Net::Sockets::AddressFamily family);
public UdpClient(int port, System.Net.Sockets.AddressFamily family);
new System.Net.Sockets.UdpClient : int * System.Net.Sockets.AddressFamily -> System.Net.Sockets.UdpClient
Public Sub New (port As Integer, family As AddressFamily)
Parametrar
- port
- Int32
Porten som du vill lyssna efter inkommande anslutningsförsök på.
- family
- AddressFamily
Ett av de AddressFamily värden som anger socketens adressschema.
Undantag
family är inte InterNetwork eller InterNetworkV6.
Ett fel uppstod vid åtkomst till socketen.
Exempel
I följande kodexempel visas hur du skapar en UDP-klient som ska användas i en multicast-grupp.
// Bind and listen on port 2000. This constructor creates a socket
// and binds it to the port on which to receive data. The family
// parameter specifies that this connection uses an IPv6 address.
clientOriginator = new UdpClient(2000, AddressFamily.InterNetworkV6);
// Join or create a multicast group. The multicast address ranges
// to use are specified in RFC#2375. You are free to use
// different addresses.
// Transform the string address into the internal format.
m_GrpAddr = IPAddress.Parse("FF01::1");
// Display the multicast address used.
Console.WriteLine("Multicast Address: [" + m_GrpAddr.ToString() + "]");
// Exercise the use of the IPv6MulticastOption.
Console.WriteLine("Instantiate IPv6MulticastOption(IPAddress)");
// Instantiate IPv6MulticastOption using one of the
// overloaded constructors.
IPv6MulticastOption ipv6MulticastOption = new IPv6MulticastOption(m_GrpAddr);
// Store the IPAdress multicast options.
IPAddress group = ipv6MulticastOption.Group;
long interfaceIndex = ipv6MulticastOption.InterfaceIndex;
// Display IPv6MulticastOption properties.
Console.WriteLine("IPv6MulticastOption.Group: [" + group + "]");
Console.WriteLine("IPv6MulticastOption.InterfaceIndex: [" + interfaceIndex + "]");
// Instantiate IPv6MulticastOption using another
// overloaded constructor.
IPv6MulticastOption ipv6MulticastOption2 = new IPv6MulticastOption(group, interfaceIndex);
// Store the IPAdress multicast options.
group = ipv6MulticastOption2.Group;
interfaceIndex = ipv6MulticastOption2.InterfaceIndex;
// Display the IPv6MulticastOption2 properties.
Console.WriteLine("IPv6MulticastOption.Group: [" + group + "]");
Console.WriteLine("IPv6MulticastOption.InterfaceIndex: [" + interfaceIndex + "]");
// Join the specified multicast group using one of the
// JoinMulticastGroup overloaded methods.
clientOriginator.JoinMulticastGroup((int)interfaceIndex, group);
// Define the endpoint data port. Note that this port number
// must match the ClientTarget UDP port number which is the
// port on which the ClientTarget is receiving data.
m_ClientTargetdest = new IPEndPoint(m_GrpAddr, 1000);
' Bind and listen on port 2000. This constructor creates a socket
' and binds it to the port on which to receive data. The family
' parameter specifies that this connection uses an IPv6 address.
clientOriginator = New UdpClient(2000, AddressFamily.InterNetworkV6)
' Join or create a multicast group. The multicast address ranges
' to use are specified in RFC#2375. You are free to use
' different addresses.
' Transform the string address into the internal format.
m_GrpAddr = IPAddress.Parse("FF01::1")
' Display the multicast address used.
Console.WriteLine(("Multicast Address: [" + m_GrpAddr.ToString() + "]"))
' Exercise the use of the IPv6MulticastOption.
Console.WriteLine("Instantiate IPv6MulticastOption(IPAddress)")
' Instantiate IPv6MulticastOption using one of the
' overloaded constructors.
Dim ipv6MulticastOption As New IPv6MulticastOption(m_GrpAddr)
' Store the IPAdress multicast options.
Dim group As IPAddress = ipv6MulticastOption.Group
Dim interfaceIndex As Long = ipv6MulticastOption.InterfaceIndex
' Display IPv6MulticastOption properties.
Console.WriteLine(("IPv6MulticastOption.Group: [" + group.ToString() + "]"))
Console.WriteLine(("IPv6MulticastOption.InterfaceIndex: [" + interfaceIndex.ToString() + "]"))
' Instantiate IPv6MulticastOption using another
' overloaded constructor.
Dim ipv6MulticastOption2 As New IPv6MulticastOption(group, interfaceIndex)
' Store the IPAdress multicast options.
group = ipv6MulticastOption2.Group
interfaceIndex = ipv6MulticastOption2.InterfaceIndex
' Display the IPv6MulticastOption2 properties.
Console.WriteLine(("IPv6MulticastOption.Group: [" + group.ToString() + "]"))
Console.WriteLine(("IPv6MulticastOption.InterfaceIndex: [" + interfaceIndex.ToString() + "]"))
' Join the specified multicast group using one of the
' JoinMulticastGroup overloaded methods.
clientOriginator.JoinMulticastGroup(Fix(interfaceIndex), group)
' Define the endpoint data port. Note that this port number
' must match the ClientTarget UDP port number which is the
' port on which the ClientTarget is receiving data.
m_ClientTargetdest = New IPEndPoint(m_GrpAddr, 1000)
Kommentarer
Den här konstruktorn skapar en underliggande Socket och binder den till det portnummer som du tänker kommunicera från.
Parametern family avgör om lyssnaren använder en IP-version 4-adress (IPv4) eller en IP-version 6-adress (IPv6). Om du vill använda en IPv4-adress skickar du InterNetwork värdet. Om du vill använda en IPv6-adress skickar du InterNetworkV6 värdet. Om du skickar ett annat värde genereras en ArgumentException.
Om den här konstruktorn används anges instansen UdpClient med den adressfamilj som anges av parametern family som inte kan ändras eller skrivas över av ett anslutningsmetodanrop med en annan adressfamilj.
Note
Om du får en SocketExceptionanvänder SocketException.ErrorCode du 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.
Gäller för
UdpClient(String, Int32)
- Källa:
- UDPClient.cs
- Källa:
- UDPClient.cs
- Källa:
- UDPClient.cs
- Källa:
- UDPClient.cs
- Källa:
- UDPClient.cs
Initierar en ny instans av UdpClient klassen och etablerar en fjärrvärd som standard.
public:
UdpClient(System::String ^ hostname, int port);
public UdpClient(string hostname, int port);
new System.Net.Sockets.UdpClient : string * int -> System.Net.Sockets.UdpClient
Public Sub New (hostname As String, port As Integer)
Parametrar
- hostname
- String
Namnet på den fjärranslutna DNS-värd som du tänker ansluta till.
- port
- Int32
Det fjärrportnummer som du tänker ansluta till.
Undantag
hostname är null.
Ett fel uppstod vid åtkomst till socketen.
Exempel
I följande exempel visas hur du skapar en instans av klassen med hjälp av UdpClient ett värdnamn och portnummer.
//Creates an instance of the UdpClient class with a remote host name and a port number.
try{
UdpClient udpClient = new UdpClient("www.contoso.com",11000);
}
catch (Exception e ) {
Console.WriteLine(e.ToString());
}
'Creates an instance of the UdpClient class with a remote host name and a port number.
Try
Dim udpClient As New UdpClient("www.contoso.com", 11000)
Catch e As Exception
Console.WriteLine(e.ToString())
End Try
Kommentarer
Den här konstruktorn initierar en ny UdpClient och etablerar en fjärrvärd med parametrarna hostname och port . Det är valfritt att upprätta en standardvärd för fjärranslutningen. Om du använder den här konstruktorn behöver du inte ange en fjärrvärd i varje anrop till Send metoden. Om du anger en fjärrvärd som standard begränsas du endast till den värden. Du kan när som helst ändra standardvärd genom att anropa Connect metoden. Om du vill ange en fjärrvärd i anropet Send till metoden ska du inte använda den här konstruktorn.
Note
Om du får en SocketExceptionanvänder SocketException.ErrorCode du för att hämta den specifika felkoden. När du har fått den här koden kan du läsa felkoden Windows Sockets version 2 API för en detaljerad beskrivning av felet.