Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
ProtocolType Enumeration

ProtocolType Enumeration

Specifies the protocols that the Socket class supports.

Namespace: System.Net.Sockets
Assembly: System (in system.dll)

'Declaration
Public Enumeration ProtocolType
'Usage
Dim instance As ProtocolType

public enum ProtocolType
public enum ProtocolType

 Member nameDescription
Supported by the .NET Compact FrameworkGgpGateway To Gateway Protocol. 
Supported by the .NET Compact FrameworkIcmpInternet Control Message Protocol. 
IcmpV6Internet Control Message Protocol for IPv6. 
Supported by the .NET Compact FrameworkIdpInternet Datagram Protocol. 
Supported by the .NET Compact FrameworkIgmpInternet Group Management Protocol. 
Supported by the .NET Compact FrameworkIPInternet Protocol. 
IPSecAuthenticationHeaderIPv6 Authentication header. For details, see RFC 2292 section 2.2.1, available at http://www.ietf.org. 
IPSecEncapsulatingSecurityPayloadIPv6 Encapsulating Security Payload header. 
IPv4Internet Protocol version 4. 
Supported by the .NET Compact FrameworkIPv6Internet Protocol version 6 (IPv6).  
IPv6DestinationOptionsIPv6 Destination Options header. 
IPv6FragmentHeaderIPv6 Fragment header. 
IPv6HopByHopOptionsIPv6 Hop by Hop Options header. 
IPv6NoNextHeaderIPv6 No next header. 
IPv6RoutingHeaderIPv6 Routing header. 
Supported by the .NET Compact FrameworkIpxInternet Packet Exchange Protocol. 
Supported by the .NET Compact FrameworkNDNet Disk Protocol (unofficial). 
Supported by the .NET Compact FrameworkPupPARC Universal Packet Protocol. 
Supported by the .NET Compact FrameworkRawRaw IP packet protocol. 
Supported by the .NET Compact FrameworkSpxSequenced Packet Exchange protocol. 
Supported by the .NET Compact FrameworkSpxIISequenced Packet Exchange version 2 protocol. 
Supported by the .NET Compact FrameworkTcpTransmission Control Protocol. 
Supported by the .NET Compact FrameworkUdpUser Datagram Protocol. 
Supported by the .NET Compact FrameworkUnknownUnknown protocol. 
Supported by the .NET Compact FrameworkUnspecifiedUnspecified protocol. 

The Socket class uses the ProtocolType enumeration to inform the Windows Sockets API of the requested protocol. Low-level driver software for the requested protocol must be present on the computer for the Socket to be created successfully.

The following example demonstrates how to use ProtocolType to instantiate a Socket.

Imports System
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 'Main
End Class 'Sample

import System.*;
import System.Text.*;
import System.IO.*;
import System.Net.*;
import 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.get_ASCII();
        String get = "GET / HTTP/1.1\r\nHost: " + server
            + "\r\nConnection: Close\r\n\r\n";
        System.Byte byteGet[] = (System.Byte[])ascii.GetBytes(get);
        System.Byte recvBytes[] = new System.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.Resolve(server);
            // Get the DNS IP addresses associated with the host.
            IPAddress IPaddresses[] = hostInfo.get_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.get_Connected())) {
                    // Connection failed, try next IPaddress.
                    strRetPage = "Unable to connect to host";
                    s = null;
                    continue;
                }
                // Sent the GET request to the host.
                s.Send((ubyte[])byteGet, byteGet.get_Length(), (SocketFlags)0);
            } // End of the for loop.      
            // Receive the host home page content and loop until all the 
            // data is received.
            Int32 bytes = (Int32)s.Receive((ubyte[])recvBytes,
                recvBytes.get_Length(), (SocketFlags)0);
            strRetPage = "Default HTML page on " + server + ":\r\n";
            strRetPage = strRetPage + ascii.GetString((ubyte[])recvBytes,
                0, Convert.ToInt32(bytes));

            while (Convert.ToInt32(bytes) > 0) {
                bytes = (Int32)s.Receive((ubyte[])recvBytes,
                    recvBytes.get_Length(), (SocketFlags)0);
                strRetPage = strRetPage
                    + ascii.GetString((ubyte[])recvBytes, 0,
                    Convert.ToInt32(bytes));
            }
        } // End of the try block.
        catch (SocketException e) {
            Console.WriteLine("SocketException caught!!!");
            Console.WriteLine("Source : " + e.get_Source());
            Console.WriteLine("Message : " + e.get_Message());
        }
        catch (ArgumentNullException e) {
            Console.WriteLine("ArgumentNullException caught!!!");
            Console.WriteLine("Source : " + e.get_Source());
            Console.WriteLine("Message : " + e.get_Message());
        }
        catch (NullReferenceException e) {
            Console.WriteLine("NullReferenceException caught!!!");
            Console.WriteLine("Source : " + e.get_Source());
            Console.WriteLine("Message : " + e.get_Message());
        }
        catch (System.Exception e) {
            Console.WriteLine("Exception caught!!!");
            Console.WriteLine("Source : " + e.get_Source());
            Console.WriteLine("Message : " + e.get_Message());
        }
        return strRetPage;
    } //DoSocketGet

    public static void main(String[] args)
    {
        Console.WriteLine(DoSocketGet("localhost"));
    } //main
} //Sample

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0

Community Additions

ADD
Show:
© 2015 Microsoft