SocketPermission.IsUnrestricted Method ()


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Checks the overall permission state of the object.

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

Public Function IsUnrestricted As Boolean

Return Value

Type: System.Boolean

true if the SocketPermission instance is created with the Unrestricted value from PermissionState; otherwise, false.

The following example checks the IsUnrestricted property to determine if the specified SocketPermission has any restrictions.

Dim socketPermission1 As New SocketPermission(PermissionState.Unrestricted)

       'Create a 'SocketPermission' object for two ip addresses.
       Dim socketPermission2 As New SocketPermission(PermissionState.None)
       Dim securityElement4 As SecurityElement = socketPermission2.ToXml()
       ''SocketPermission' object for 'Connect' permission
       Dim securityElement1 As New SecurityElement("ConnectAccess")
       'Format to specify ip address are <ip-address>#<port>#<transport-type>
       'First 'SocketPermission' ip-address is '' for 'All' transport types and for 'All' ports for the ip-address.
       Dim securityElement2 As New SecurityElement("URI", "")
       'Second 'SocketPermission' ip-address is '' for 'All' transport types and for 'All' ports for the ip-address.
       Dim securityElement3 As New SecurityElement("URI", "")

       'Obtain a 'SocketPermission' object using 'FromXml' method.	

       'Create another 'SocketPermission' object with two ip addresses.
       'First 'SocketPermission' ip-address is '' for 'All' transport types and for 'All' ports for the ip-address.
       Dim socketPermission3 As New SocketPermission(NetworkAccess.Connect, TransportType.All, "", SocketPermission.AllPorts)

       'Second 'SocketPermission' ip-address is '' for 'All' transport types and for 'All' ports for the ip-address.
       socketPermission3.AddPermission(NetworkAccess.Connect, TransportType.All, "", SocketPermission.AllPorts)

       Console.WriteLine(ControlChars.Cr + "Checks the Socket permissions using IsUnrestricted method : ")
       If socketPermission1.IsUnrestricted() Then
           Console.WriteLine("Socket permission is unrestricted")
           Console.WriteLine("Socket permission is restricted")
       End If 

       Console.WriteLine("Display result of ConnectList property : " + ControlChars.Cr)
       Dim enumerator As IEnumerator = socketPermission3.ConnectList
       While enumerator.MoveNext()
           Console.WriteLine("The hostname is       : {0}", CType(enumerator.Current, EndpointPermission).Hostname)
           Console.WriteLine("The port is           : {0}", CType(enumerator.Current, EndpointPermission).Port)
           Console.WriteLine("The Transport type is : {0}", CType(enumerator.Current, EndpointPermission).Transport)
       End While


       Console.WriteLine("Display Security Elements :" + ControlChars.Cr + " ")
       PrintSecurityElement(socketPermission2.ToXml(), 0)

       'Get a 'SocketPermission' object which is a union of two other 'SocketPermission' objects.
       socketPermission1 = CType(socketPermission3.Union(socketPermission2), SocketPermission)

       'Demand that the calling method have the socket permission.

.NET Framework
Available since 1.1
Return to top