Port Class

.NET Framework (current version)

Defines an individual endpoint contained in the XML Web service. This class cannot be inherited.

Namespace: System.Web.Services.Description
Assembly: System.Web.Services (in System.Web.Services.dll)

Inheritance Hierarchy

System.Object
System.Web.Services.Description.DocumentableItem
System.Web.Services.Description.NamedItem
System.Web.Services.Description.Port

Syntax

C++

[XmlFormatExtensionPointAttribute("Extensions")]
public sealed class Port : NamedItem

Constructors

	Name	Description
	Port()	Initializes a new instance of the Port class.

Properties

	Name	Description
	Binding	Gets or sets the value of the XML <binding> attribute of the Port.
	Documentation	Gets or sets the text documentation for the instance of the DocumentableItem.(Inherited from DocumentableItem.)
	DocumentationElement	Gets or sets the documentation element for the DocumentableItem.(Inherited from DocumentableItem.)
	ExtensibleAttributes	Gets or sets an array of type XmlAttribute that represents attribute extensions of WSDL to comply with Web Services Interoperability (WS-I) Basic Profile 1.1.(Inherited from DocumentableItem.)
	Extensions	Gets the collection of extensibility elements associated with the Port.(Overrides DocumentableItem.Extensions.)
	Name	Gets or sets the name of the item.(Inherited from NamedItem.)
	Namespaces	Gets or sets the dictionary of namespace prefixes and namespaces used to preserve namespace prefixes and namespaces when a ServiceDescription object is constructed.(Inherited from DocumentableItem.)
	Service	Gets the Service of which the Port is a member.

Methods

	Name	Description
	Equals(Object)	Determines whether the specified object is equal to the current object.(Inherited from Object.)
	GetHashCode()	Serves as the default hash function. (Inherited from Object.)
	GetType()	Gets the Type of the current instance.(Inherited from Object.)
	ToString()	Returns a string that represents the current object.(Inherited from Object.)

This class specifies a single address (URI) for a Binding, which defines message format and protocol details for operations and messages for a given PortType. The Binding property gets or sets those values for a specified Port.

This class corresponds to the Web Services Description Language (WSDL) <port> element, which is enclosed by the <service> element. For more information about WSDL, see the specification at http://www.w3.org/TR/wsdl.

Examples

The following examples creates a Port and adds it to the Ports collection of an existing ServiceDescription named myDescription.

C++

// Create a Port.
Port postPort = new Port();
postPort.Name = "PortServiceHttpPost";
postPort.Binding = new XmlQualifiedName("s0:PortServiceHttpPost");

// Create an HttpAddressBinding.
HttpAddressBinding postAddressBinding = new HttpAddressBinding();
postAddressBinding.Location = 
   "http://localhost/PortClass/PortService_cs.asmx";

// Add the HttpAddressBinding to the Port.
postPort.Extensions.Add(postAddressBinding);

// Get the Service of the postPort.
Service myService = postPort.Service;

// Print the service name for the port.
Console.WriteLine("This is the service name of the postPort:*" +
   myDescription.Services[0].Ports[0].Service.Name + "*");

// Add the Port to the PortCollection of the ServiceDescription.
myDescription.Services[0].Ports.Add(postPort);

Version Information

.NET Framework
Available since 1.1

Thread Safety

Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.