ServiceEndpointCollection.Find Method

Definition

Namespace:

System.ServiceModel.Description

Assembly:

System.ServiceModel.dll

Returns the first service endpoint found that satisfies specific criteria from the collection of service endpoints.

Overloads

Find(Type)	Returns the first service endpoint found that satisfies the specified contract type from the collection of service endpoints.
Find(Uri)	Returns a service endpoint with a specified address from the collection of service endpoints.
Find(XmlQualifiedName)	Returns a service endpoint with a specified namespace and contract name from the collection of service endpoints.
Find(Type, XmlQualifiedName)	Returns a service endpoint of a specified contract type and with a specified binding name and namespace from the collection of service endpoints.
Find(XmlQualifiedName, XmlQualifiedName)	Returns the first service endpoint with the specified contract name and namespace and binding name and namespace from the collection of service endpoints.

Remarks

There are potentially multiple endpoints that could satisfy the criteria. The method returns the first one encountered in the collection. If you need to find all of the ServiceEndpoint objects that satisfy the specified criteria, use one of the FindAll methods instead.

Find(Type)

Returns the first service endpoint found that satisfies the specified contract type from the collection of service endpoints.

public:
 System::ServiceModel::Description::ServiceEndpoint ^ Find(Type ^ contractType);

public System.ServiceModel.Description.ServiceEndpoint Find (Type contractType);

member this.Find : Type -> System.ServiceModel.Description.ServiceEndpoint

Public Function Find (contractType As Type) As ServiceEndpoint

Parameters

contractType

Type

The Type of contract for the service endpoint.

Returns

ServiceEndpoint

The first ServiceEndpoint of the specified contract type or null if none was found.

Exceptions

ArgumentNullException

contractType is null.

Remarks

This Find(Type) overload is specific to the Windows Communication Foundation (WCF) programming model. It looks at the ContractType property for each endpoint. The ContractType may be null if the ContractDescription was not created from the WCF programming model (types with *Contract attributes).

There are potentially multiple endpoints that could satisfy the criteria. The method returns the first one encountered in the collection. If you need to find all of the ServiceEndpoint objects that satisfy the specified criteria, use one of the FindAll methods instead.

Find(Uri)

Returns a service endpoint with a specified address from the collection of service endpoints.

public:
 System::ServiceModel::Description::ServiceEndpoint ^ Find(Uri ^ address);

public System.ServiceModel.Description.ServiceEndpoint Find (Uri address);

member this.Find : Uri -> System.ServiceModel.Description.ServiceEndpoint

Public Function Find (address As Uri) As ServiceEndpoint

Parameters

address

Uri

The Uri for the service endpoint.

Returns

ServiceEndpoint

The first ServiceEndpoint of the specified address or null if none was found.

Exceptions

ArgumentNullException

address is null.

Remarks

There are potentially multiple endpoints that could satisfy the criteria. The method returns the first one encountered in the collection. If you need to find all of the ServiceEndpoint objects that satisfy the specified criteria, use one of the FindAll methods instead.

Find(XmlQualifiedName)

Returns a service endpoint with a specified namespace and contract name from the collection of service endpoints.

public:
 System::ServiceModel::Description::ServiceEndpoint ^ Find(System::Xml::XmlQualifiedName ^ contractName);

public System.ServiceModel.Description.ServiceEndpoint Find (System.Xml.XmlQualifiedName contractName);

member this.Find : System.Xml.XmlQualifiedName -> System.ServiceModel.Description.ServiceEndpoint

Public Function Find (contractName As XmlQualifiedName) As ServiceEndpoint

Parameters

contractName

XmlQualifiedName

The XmlQualifiedName for the contract of the service.

Returns

ServiceEndpoint

The first ServiceEndpoint with the specified namespace and contract name or null if none was found.

Remarks

There are potentially multiple endpoints that could satisfy the criteria. The method returns the first one encountered in the collection. If you need to find all of the ServiceEndpoint objects that satisfy the specified criteria, use one of the FindAll methods instead.

Find(Type, XmlQualifiedName)

Returns a service endpoint of a specified contract type and with a specified binding name and namespace from the collection of service endpoints.

public:
 System::ServiceModel::Description::ServiceEndpoint ^ Find(Type ^ contractType, System::Xml::XmlQualifiedName ^ bindingName);

public System.ServiceModel.Description.ServiceEndpoint Find (Type contractType, System.Xml.XmlQualifiedName bindingName);

member this.Find : Type * System.Xml.XmlQualifiedName -> System.ServiceModel.Description.ServiceEndpoint

Public Function Find (contractType As Type, bindingName As XmlQualifiedName) As ServiceEndpoint

Parameters

contractType

Type

The Type of contract for the service endpoint.

bindingName

XmlQualifiedName

The XmlQualifiedName for the binding of the service.

Returns

ServiceEndpoint

The first ServiceEndpoint of the specified contract type and binding name and namespace or null if none was found.

Exceptions

ArgumentNullException

contractType or bindingName is null.

Remarks

There are potentially multiple endpoints that could satisfy the criteria. The method returns the first one encountered in the collection. If you need to find all of the ServiceEndpoint objects that satisfy the specified criteria, use one of the FindAll methods instead.

Find(XmlQualifiedName, XmlQualifiedName)

Returns the first service endpoint with the specified contract name and namespace and binding name and namespace from the collection of service endpoints.

public:
 System::ServiceModel::Description::ServiceEndpoint ^ Find(System::Xml::XmlQualifiedName ^ contractName, System::Xml::XmlQualifiedName ^ bindingName);

public System.ServiceModel.Description.ServiceEndpoint Find (System.Xml.XmlQualifiedName contractName, System.Xml.XmlQualifiedName bindingName);

member this.Find : System.Xml.XmlQualifiedName * System.Xml.XmlQualifiedName -> System.ServiceModel.Description.ServiceEndpoint

Public Function Find (contractName As XmlQualifiedName, bindingName As XmlQualifiedName) As ServiceEndpoint

Parameters

contractName

XmlQualifiedName

The XmlQualifiedName for the contract of the service.

bindingName

XmlQualifiedName

The XmlQualifiedName for the binding of the service.

Returns

ServiceEndpoint

The first ServiceEndpoint with the specified binding and contract names and namespaces.

Exceptions

ArgumentNullException

contractName or bindingName is null.

Remarks

There are potentially multiple endpoints that could satisfy the criteria. The method returns the first one encountered in the collection. If you need to find all of the ServiceEndpoint objects that satisfy the specified criteria, use one of the FindAll methods instead.