Freigeben über


Socket Konstruktoren

Definition

Initialisiert eine neue Instanz der Socket-Klasse.

Überlädt

Name Beschreibung
Socket(SafeSocketHandle)

Initialisiert eine neue Instanz der Socket Klasse für das angegebene Sockethandle.

Socket(SocketInformation)

Initialisiert eine neue Instanz der Socket Klasse mithilfe des angegebenen Werts, der von DuplicateAndClose(Int32).

Socket(SocketType, ProtocolType)

Initialisiert eine neue Instanz der Socket Klasse mithilfe des angegebenen Sockettyps und Protokolls. Wenn das Betriebssystem IPv6 unterstützt, erstellt dieser Konstruktor einen Dualmodus-Socket; andernfalls wird ein IPv4-Socket erstellt.

Socket(AddressFamily, SocketType, ProtocolType)

Initialisiert eine neue Instanz der Klasse mithilfe der Socket angegebenen Adressfamilie, des Sockettyps und des Protokolls.

Socket(SafeSocketHandle)

Quelle:
Socket.cs
Quelle:
Socket.cs
Quelle:
Socket.cs
Quelle:
Socket.cs
Quelle:
Socket.cs

Initialisiert eine neue Instanz der Socket Klasse für das angegebene Sockethandle.

public:
 Socket(System::Net::Sockets::SafeSocketHandle ^ handle);
public Socket(System.Net.Sockets.SafeSocketHandle handle);
new System.Net.Sockets.Socket : System.Net.Sockets.SafeSocketHandle -> System.Net.Sockets.Socket
Public Sub New (handle As SafeSocketHandle)

Parameter

handle
SafeSocketHandle

Das Sockethandle für den Socket, den das Socket Objekt kapselt.

Ausnahmen

handle ist null.

handle ist ungültig.

handle ist kein Socket oder keine Informationen zum Socket, auf die nicht zugegriffen werden konnte.

Hinweise

Mit dieser Methode wird die Socket Instanz mit daten aufgefüllt, die aus der bereitgestellten Methode SafeSocketHandlegesammelt wurden. Verschiedene Betriebssysteme bieten unterschiedliche Unterstützungsebenen für das Abfragen eines Sockethandles oder dateideskriptors für die zugehörigen Eigenschaften und Konfigurationen. Einige der öffentlichen APIs für die resultierende Socket Instanz können sich je nach Betriebssystem unterscheiden, z ProtocolType . B. und Blocking.

Gilt für:

Socket(SocketInformation)

Quelle:
Socket.cs
Quelle:
Socket.cs
Quelle:
Socket.cs
Quelle:
Socket.cs
Quelle:
Socket.cs

Initialisiert eine neue Instanz der Socket Klasse mithilfe des angegebenen Werts, der von DuplicateAndClose(Int32).

public:
 Socket(System::Net::Sockets::SocketInformation socketInformation);
[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public Socket(System.Net.Sockets.SocketInformation socketInformation);
public Socket(System.Net.Sockets.SocketInformation socketInformation);
[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
new System.Net.Sockets.Socket : System.Net.Sockets.SocketInformation -> System.Net.Sockets.Socket
new System.Net.Sockets.Socket : System.Net.Sockets.SocketInformation -> System.Net.Sockets.Socket
Public Sub New (socketInformation As SocketInformation)

Parameter

socketInformation
SocketInformation

Die socketinformationen, die von DuplicateAndClose(Int32).

Attribute

Hinweise

Wenn Sie den Socket Konstruktor mehrmals mit demselben Bytearray wie das Argument für jeden Aufruf aufrufen, erstellen Sie mehrere verwaltete SocketS mit demselben zugrunde liegenden Socket. Diese Praxis wird dringend abgeraten.

Gilt für:

Socket(SocketType, ProtocolType)

Quelle:
Socket.cs
Quelle:
Socket.cs
Quelle:
Socket.cs
Quelle:
Socket.cs
Quelle:
Socket.cs

Initialisiert eine neue Instanz der Socket Klasse mithilfe des angegebenen Sockettyps und Protokolls. Wenn das Betriebssystem IPv6 unterstützt, erstellt dieser Konstruktor einen Dualmodus-Socket; andernfalls wird ein IPv4-Socket erstellt.

public:
 Socket(System::Net::Sockets::SocketType socketType, System::Net::Sockets::ProtocolType protocolType);
public Socket(System.Net.Sockets.SocketType socketType, System.Net.Sockets.ProtocolType protocolType);
new System.Net.Sockets.Socket : System.Net.Sockets.SocketType * System.Net.Sockets.ProtocolType -> System.Net.Sockets.Socket
Public Sub New (socketType As SocketType, protocolType As ProtocolType)

Parameter

socketType
SocketType

Einer der SocketType Werte.

protocolType
ProtocolType

Einer der ProtocolType Werte.

Ausnahmen

Die Kombination von socketType und protocolType führt zu einem ungültigen Socket.

Hinweise

Der socketType Parameter gibt den Typ der Socket Klasse an, und der protocolType Parameter gibt das von Socket. Die beiden Parameter sind nicht unabhängig. Häufig ist der Socket Typ implizit im Protokoll. Wenn die Kombination aus Socket Typ und Protokolltyp zu einem ungültigen SocketErgebnis führt, löst dieser Konstruktor einen SocketException.

Hinweis

Wenn dieser Konstruktor eingibt SocketException, verwenden Sie die SocketException.ErrorCode Eigenschaft, um den spezifischen Fehlercode abzurufen. Nachdem Sie diesen Code erhalten haben, finden Sie in der Windows Sockets Version 2-API-Fehlercodedokumentation eine detaillierte Beschreibung des Fehlers.

Hinweis

Dieses Mitglied gibt Protokollierungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in Ihrer Anwendung aktivieren. Weitere Informationen finden Sie unter Network Tracing in .NET Framework.

Gilt für:

Socket(AddressFamily, SocketType, ProtocolType)

Quelle:
Socket.cs
Quelle:
Socket.cs
Quelle:
Socket.cs
Quelle:
Socket.cs
Quelle:
Socket.cs

Initialisiert eine neue Instanz der Klasse mithilfe der Socket angegebenen Adressfamilie, des Sockettyps und des Protokolls.

public:
 Socket(System::Net::Sockets::AddressFamily addressFamily, System::Net::Sockets::SocketType socketType, System::Net::Sockets::ProtocolType protocolType);
public Socket(System.Net.Sockets.AddressFamily addressFamily, System.Net.Sockets.SocketType socketType, System.Net.Sockets.ProtocolType protocolType);
new System.Net.Sockets.Socket : System.Net.Sockets.AddressFamily * System.Net.Sockets.SocketType * System.Net.Sockets.ProtocolType -> System.Net.Sockets.Socket
Public Sub New (addressFamily As AddressFamily, socketType As SocketType, protocolType As ProtocolType)

Parameter

addressFamily
AddressFamily

Einer der AddressFamily Werte.

socketType
SocketType

Einer der SocketType Werte.

protocolType
ProtocolType

Einer der ProtocolType Werte.

Ausnahmen

Die Kombination von addressFamily, socketTypeund protocolType führt zu einem ungültigen Socket.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie eine Instanz der Socket Klasse erstellt wird.

using System;
using System.Text;
using System.IO;
using System.Net;
using System.Net.Sockets;

public class Sample
{

  public static string DoSocketGet(string server)
  {
    //Set up variables and String to write to the server.
    Encoding ASCII = Encoding.ASCII;
    string Get = "GET / HTTP/1.1\r\nHost: " + server +
                 "\r\nConnection: Close\r\n\r\n";
    Byte[] ByteGet = ASCII.GetBytes(Get);
    Byte[] RecvBytes = new Byte[256];
    String strRetPage = null;

    // IPAddress and IPEndPoint represent the endpoint that will
    //   receive the request.
    // Get first IPAddress in list return by DNS.

    try
    {

      // Define those variables to be evaluated in the next for loop and
      // then used to connect to the server. These variables are defined
      // outside the for loop to make them accessible there after.
      Socket s = null;
      IPEndPoint hostEndPoint;
      IPAddress hostAddress = null;
      int conPort = 80;

      // Get DNS host information.
      IPHostEntry hostInfo = Dns.GetHostEntry(server);
      // Get the DNS IP addresses associated with the host.
      IPAddress[] IPaddresses = hostInfo.AddressList;

      // Evaluate the socket and receiving host IPAddress and IPEndPoint.
      for (int index=0; index<IPaddresses.Length; index++)
      {
        hostAddress = IPaddresses[index];
        hostEndPoint = new IPEndPoint(hostAddress, conPort);


        // Creates the Socket to send data over a TCP connection.
        s = new Socket(AddressFamily.InterNetwork, SocketType.Stream, ProtocolType.Tcp );


        // Connect to the host using its IPEndPoint.
        s.Connect(hostEndPoint);

        if (!s.Connected)
        {
          // Connection failed, try next IPaddress.
          strRetPage = "Unable to connect to host";
          s = null;
          continue;
        }

        // Sent the GET request to the host.
        s.Send(ByteGet, ByteGet.Length, 0);

      } // End of the for loop.


      // Receive the host home page content and loop until all the data is received.
      Int32 bytes = s.Receive(RecvBytes, RecvBytes.Length, 0);
      strRetPage = "Default HTML page on " + server + ":\r\n";
      strRetPage = strRetPage + ASCII.GetString(RecvBytes, 0, bytes);

      while (bytes > 0)
      {
        bytes = s.Receive(RecvBytes, RecvBytes.Length, 0);
        strRetPage = strRetPage + ASCII.GetString(RecvBytes, 0, bytes);
      }

    } // End of the try block.

    catch(SocketException e)
    {
      Console.WriteLine("SocketException caught!!!");
      Console.WriteLine("Source : " + e.Source);
      Console.WriteLine("Message : " + e.Message);
    }
    catch(ArgumentNullException e)
    {
      Console.WriteLine("ArgumentNullException caught!!!");
      Console.WriteLine("Source : " + e.Source);
      Console.WriteLine("Message : " + e.Message);
    }
    catch(NullReferenceException e)
    {
      Console.WriteLine("NullReferenceException caught!!!");
      Console.WriteLine("Source : " + e.Source);
      Console.WriteLine("Message : " + e.Message);
    }
    catch(Exception e)
    {
      Console.WriteLine("Exception caught!!!");
      Console.WriteLine("Source : " + e.Source);
      Console.WriteLine("Message : " + e.Message);
    }

    return strRetPage;
}
   public static void Main()
   {
      Console.WriteLine(DoSocketGet("localhost"));
   }
 }
Imports System.Text
Imports System.IO
Imports System.Net
Imports System.Net.Sockets

 _

Public Class Sample
   
   
   Public Shared Function DoSocketGet(server As String) As String
      'Set up variables and String to write to the server.
    Dim ASCII As Encoding = Encoding.ASCII
    Dim [Get] As String = "GET / HTTP/1.1" + ControlChars.Lf + ControlChars.NewLine + "Host: " + server + ControlChars.Lf + ControlChars.NewLine + "Connection: Close" + ControlChars.Lf + ControlChars.NewLine + ControlChars.Lf + ControlChars.NewLine
    Dim ByteGet As [Byte]() = ASCII.GetBytes([Get])
    Dim RecvBytes(256) As [Byte]
    Dim strRetPage As [String] = Nothing


      
      ' IPAddress and IPEndPoint represent the endpoint that will
      '   receive the request.
      ' Get first IPAddress in list return by DNS.
      Try

 

         ' Define those variables to be evaluated in the next for loop and 
         ' then used to connect to the server. These variables are defined
         ' outside the for loop to make them accessible there after.
         Dim s As Socket = Nothing
         Dim hostEndPoint As IPEndPoint
         Dim hostAddress As IPAddress = Nothing
         Dim conPort As Integer = 80
         
         ' Get DNS host information.
         Dim hostInfo As IPHostEntry = Dns.Resolve(server)
         ' Get the DNS IP addresses associated with the host.
         Dim IPaddresses As IPAddress() = hostInfo.AddressList
         
         ' Evaluate the socket and receiving host IPAddress and IPEndPoint. 
      Dim index As Integer = 0
      For index = 0 To IPaddresses.Length - 1
        hostAddress = IPaddresses(index)
        hostEndPoint = New IPEndPoint(hostAddress, conPort)


        ' Creates the Socket to send data over a TCP connection.
        s = New Socket(AddressFamily.InterNetwork, SocketType.Stream, ProtocolType.Tcp)


        ' Connect to the host using its IPEndPoint.
        s.Connect(hostEndPoint)

        If Not s.Connected Then
          ' Connection failed, try next IPaddress.
          strRetPage = "Unable to connect to host"
          s = Nothing
          GoTo ContinueFor1
        End If


        ' Sent the GET request to the host.
        s.Send(ByteGet, ByteGet.Length, 0)


ContinueFor1:
      Next index  ' End of the for loop.
      



      ' Receive the host home page content and loop until all the data is received.

      'Dim bytes As Int32 = s.Receive(RecvBytes, RecvBytes.Length, 0)
      Dim bytes As Int32 = s.Receive(RecvBytes, RecvBytes.Length, 0)

      strRetPage = "Default HTML page on " + server + ":\r\n"
      strRetPage = "Default HTML page on " + server + ":" + ControlChars.Lf + ControlChars.NewLine

      Dim i As Integer

      While bytes > 0

        bytes = s.Receive(RecvBytes, RecvBytes.Length, 0)

        strRetPage = strRetPage + ASCII.GetString(RecvBytes, 0, bytes)

      End While


      ' End of the try block.
    Catch e As SocketException
         Console.WriteLine("SocketException caught!!!")
         Console.WriteLine(("Source : " + e.Source))
         Console.WriteLine(("Message : " + e.Message))
      Catch e As ArgumentNullException
         Console.WriteLine("ArgumentNullException caught!!!")
         Console.WriteLine(("Source : " + e.Source))
         Console.WriteLine(("Message : " + e.Message))
      Catch e As NullReferenceException
         Console.WriteLine("NullReferenceException caught!!!")
         Console.WriteLine(("Source : " + e.Source))
         Console.WriteLine(("Message : " + e.Message))
      Catch e As Exception
         Console.WriteLine("Exception caught!!!")
         Console.WriteLine(("Source : " + e.Source))
         Console.WriteLine(("Message : " + e.Message))
      End Try
      
      Return strRetPage
   End Function 'DoSocketGet
    
   Public Shared Sub Main()
    Console.WriteLine(DoSocketGet("localhost"))
   End Sub
End Class

Hinweise

Der addressFamily Parameter gibt das Adressierungsschema an, das von der Socket Klasse verwendet wird, der socketType Parameter gibt den Typ der Socket Klasse an, und der protocolType Parameter gibt das von Socket. Die drei Parameter sind nicht unabhängig. Einige Adressfamilien beschränken, welche Protokolle mit ihnen verwendet werden können, und häufig ist der Socket Typ im Protokoll implizit. Wenn die Kombination aus Adressfamilie, Socket Typ und Protokolltyp zu einem ungültigen SocketErgebnis führt, löst dieser Konstruktor einen SocketException.

Hinweis

Wenn dieser Konstruktor eingibt SocketException, verwenden Sie die SocketException.ErrorCode Eigenschaft, um den spezifischen Fehlercode abzurufen. Nachdem Sie diesen Code erhalten haben, finden Sie in der Windows Sockets Version 2-API-Fehlercodedokumentation eine detaillierte Beschreibung des Fehlers.

Hinweis

Dieses Mitglied gibt Protokollierungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in Ihrer Anwendung aktivieren. Weitere Informationen finden Sie unter Network Tracing in .NET Framework.

Weitere Informationen

Gilt für: