OperationBinding Class
Provides specifications for protocols and data formats for the messages used in the action supported by the XML Web service. This class cannot be inherited.
For a list of all members of this type, see OperationBinding Members.
System.Object
System.Web.Services.Description.DocumentableItem
System.Web.Services.Description.OperationBinding
[Visual Basic] NotInheritable Public Class OperationBinding Inherits DocumentableItem [C#] public sealed class OperationBinding : DocumentableItem [C++] public __gc __sealed class OperationBinding : public DocumentableItem [JScript] public class OperationBinding extends DocumentableItem
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.
Remarks
The OperationBinding class corresponds to the Web Services Description Language (WSDL) <operation> element enclosed by the <binding> element, which in turn corresponds to the Binding class. For more information about WSDL, see the specification at http://www.w3.org/TR/wsdl/.
Example
[Visual Basic, C#, C++] The following example demonstrates the use of the properties and methods exposed by the OperationBinding class. It takes an existing ServiceDescription and adds support for the SOAP protocol.
[Visual Basic] Imports System Imports System.Web.Services.Description Class MyOperationBindingSample Shared Sub Main() Try Dim myServiceDescription As ServiceDescription = _ ServiceDescription.Read("MathService_input_vb.wsdl") Dim myTargetNamespace As String = _ myServiceDescription.TargetNamespace ' Create an OperationBinding for the Add operation. Dim addOperationBinding As New OperationBinding() Dim addOperation As String = "Add" addOperationBinding.Name = addOperation ' Create an InputBinding for the Add operation. Dim myInputBinding As New InputBinding() Dim mySoapBodyBinding As New SoapBodyBinding() mySoapBodyBinding.Use = SoapBindingUse.Literal myInputBinding.Extensions.Add(mySoapBodyBinding) ' Add the InputBinding to the OperationBinding. addOperationBinding.Input = myInputBinding ' Create an OutputBinding for the Add operation. Dim myOutputBinding As New OutputBinding() myOutputBinding.Extensions.Add(mySoapBodyBinding) ' Add the OutputBinding to the OperationBinding. addOperationBinding.Output = myOutputBinding ' Create an extensibility element for a SoapOperationBinding. Dim mySoapOperationBinding As New SoapOperationBinding() mySoapOperationBinding.Style = SoapBindingStyle.Document mySoapOperationBinding.SoapAction = myTargetNamespace & addOperation ' Add the extensibility element SoapOperationBinding to ' the OperationBinding. addOperationBinding.Extensions.Add(mySoapOperationBinding) Dim myExtensions As ServiceDescriptionFormatExtensionCollection ' Get the FaultBindingCollection from the OperationBinding. Dim myFaultBindingCollection As FaultBindingCollection = _ addOperationBinding.Faults Dim myFaultBinding As New FaultBinding() myFaultBinding.Name = "ErrorFloat" ' Associate SOAP fault binding to the fault binding of the operation. myExtensions = myFaultBinding.Extensions Dim mySoapFaultBinding As New SoapFaultBinding() mySoapFaultBinding.Use = SoapBindingUse.Literal mySoapFaultBinding.Namespace = myTargetNamespace myExtensions.Add(mySoapFaultBinding) myFaultBindingCollection.Add(myFaultBinding) ' Get the BindingCollection from the ServiceDescription. Dim myBindingCollection As BindingCollection = _ myServiceDescription.Bindings ' Get the OperationBindingCollection of SOAP binding ' from the BindingCollection. Dim myOperationBindingCollection As OperationBindingCollection = _ myBindingCollection(0).Operations myOperationBindingCollection.Add(addOperationBinding) Console.WriteLine( _ "The operations supported by this service are:") Dim myOperationBinding As OperationBinding For Each myOperationBinding In myOperationBindingCollection Dim myBinding As Binding = myOperationBinding.Binding Console.WriteLine(" Binding : " & myBinding.Name & _ " :: Name of operation : " & myOperationBinding.Name) Dim myFaultBindingCollection1 As FaultBindingCollection = _ myOperationBinding.Faults Dim myFaultBinding1 As FaultBinding For Each myFaultBinding1 In myFaultBindingCollection1 Console.WriteLine(" Fault : " & myFaultBinding1.Name) Next myFaultBinding1 Next myOperationBinding ' Save the ServiceDescripition to an external file. myServiceDescription.Write("MathService_new_vb.wsdl") Catch e As Exception Console.WriteLine("Exception caught!!!") Console.WriteLine("Source : " & e.Source.ToString()) Console.WriteLine("Message : " & e.Message.ToString()) End Try End Sub 'Main End Class 'MyOperationBindingSample [C#] using System; using System.Web.Services.Description; class MyOperationBindingSample { static void Main() { try { ServiceDescription myServiceDescription = ServiceDescription.Read("MathService_input_cs.wsdl"); string myTargetNamespace = myServiceDescription.TargetNamespace; // Create an OperationBinding for the Add operation. OperationBinding addOperationBinding = new OperationBinding(); string addOperation = "Add"; addOperationBinding.Name = addOperation; // Create an InputBinding for the Add operation. InputBinding myInputBinding = new InputBinding(); SoapBodyBinding mySoapBodyBinding = new SoapBodyBinding(); mySoapBodyBinding.Use = SoapBindingUse.Literal; myInputBinding.Extensions.Add(mySoapBodyBinding); // Add the InputBinding to the OperationBinding. addOperationBinding.Input = myInputBinding; // Create an OutputBinding for the Add operation. OutputBinding myOutputBinding = new OutputBinding(); myOutputBinding.Extensions.Add(mySoapBodyBinding); // Add the OutputBinding to the OperationBinding. addOperationBinding.Output = myOutputBinding; // Create an extensibility element for a SoapOperationBinding. SoapOperationBinding mySoapOperationBinding = new SoapOperationBinding(); mySoapOperationBinding.Style = SoapBindingStyle.Document; mySoapOperationBinding.SoapAction = myTargetNamespace + addOperation; // Add the extensibility element SoapOperationBinding to // the OperationBinding. addOperationBinding.Extensions.Add(mySoapOperationBinding); ServiceDescriptionFormatExtensionCollection myExtensions; // Get the FaultBindingCollection from the OperationBinding. FaultBindingCollection myFaultBindingCollection = addOperationBinding.Faults; FaultBinding myFaultBinding = new FaultBinding(); myFaultBinding.Name = "ErrorFloat"; // Associate SOAP fault binding to the fault binding of the operation. myExtensions = myFaultBinding.Extensions; SoapFaultBinding mySoapFaultBinding = new SoapFaultBinding(); mySoapFaultBinding.Use = SoapBindingUse.Literal; mySoapFaultBinding.Namespace = myTargetNamespace; myExtensions.Add(mySoapFaultBinding); myFaultBindingCollection.Add(myFaultBinding); // Get the BindingCollection from the ServiceDescription. BindingCollection myBindingCollection = myServiceDescription.Bindings; // Get the OperationBindingCollection of SOAP binding // from the BindingCollection. OperationBindingCollection myOperationBindingCollection = myBindingCollection[0].Operations; myOperationBindingCollection.Add(addOperationBinding); Console.WriteLine( "The operations supported by this service are:"); foreach(OperationBinding myOperationBinding in myOperationBindingCollection) { Binding myBinding = myOperationBinding.Binding; Console.WriteLine(" Binding : " + myBinding.Name + " :: Name of operation : " + myOperationBinding.Name); FaultBindingCollection myFaultBindingCollection1 = myOperationBinding.Faults; foreach(FaultBinding myFaultBinding1 in myFaultBindingCollection1) { Console.WriteLine(" Fault : " + myFaultBinding1.Name); } } // Save the ServiceDescripition to an external file. myServiceDescription.Write("MathService_new_cs.wsdl"); } catch(Exception e) { Console.WriteLine("Exception caught!!!"); Console.WriteLine("Source : " + e.Source); Console.WriteLine("Message : " + e.Message); } } } [C++] #using <mscorlib.dll> #using <System.Xml.dll> #using <System.Web.Services.dll> #using <System.dll> using namespace System; using namespace System::Web::Services::Description; int main() { try { ServiceDescription* myServiceDescription = ServiceDescription::Read(S"MathService_input_cs.wsdl"); String* myTargetNamespace = myServiceDescription->TargetNamespace; // Create an OperationBinding for the Add operation. OperationBinding* addOperationBinding = new OperationBinding(); String* addOperation = S"Add"; addOperationBinding->Name = addOperation; // Create an InputBinding for the Add operation. InputBinding* myInputBinding = new InputBinding(); SoapBodyBinding* mySoapBodyBinding = new SoapBodyBinding(); mySoapBodyBinding->Use = SoapBindingUse::Literal; myInputBinding->Extensions->Add(mySoapBodyBinding); // Add the InputBinding to the OperationBinding. addOperationBinding->Input = myInputBinding; // Create an OutputBinding for the Add operation. OutputBinding* myOutputBinding = new OutputBinding(); myOutputBinding->Extensions->Add(mySoapBodyBinding); // Add the OutputBinding to the OperationBinding. addOperationBinding->Output = myOutputBinding; // Create an extensibility element for a SoapOperationBinding. SoapOperationBinding* mySoapOperationBinding = new SoapOperationBinding(); mySoapOperationBinding->Style = SoapBindingStyle::Document; mySoapOperationBinding->SoapAction = String::Concat( myTargetNamespace, addOperation ); // Add the extensibility element SoapOperationBinding to // the OperationBinding. addOperationBinding->Extensions->Add(mySoapOperationBinding); ServiceDescriptionFormatExtensionCollection* myExtensions; // Get the FaultBindingCollection from the OperationBinding. FaultBindingCollection* myFaultBindingCollection = addOperationBinding->Faults; FaultBinding* myFaultBinding = new FaultBinding(); myFaultBinding->Name = S"ErrorFloat"; // Associate SOAP fault binding to the fault binding of the operation. myExtensions = myFaultBinding->Extensions; SoapFaultBinding* mySoapFaultBinding = new SoapFaultBinding(); mySoapFaultBinding->Use = SoapBindingUse::Literal; mySoapFaultBinding->Namespace = myTargetNamespace; myExtensions->Add(mySoapFaultBinding); myFaultBindingCollection->Add(myFaultBinding); // Get the BindingCollection from the ServiceDescription. BindingCollection* myBindingCollection = myServiceDescription->Bindings; // Get the OperationBindingCollection of SOAP binding // from the BindingCollection. OperationBindingCollection* myOperationBindingCollection = myBindingCollection->Item[0]->Operations; myOperationBindingCollection->Add(addOperationBinding); Console::WriteLine( S"The operations supported by this service are:"); System::Collections::IEnumerator* myEnum = myOperationBindingCollection->GetEnumerator(); while (myEnum->MoveNext()) { OperationBinding* myOperationBinding = __try_cast<OperationBinding*>(myEnum->Current); Binding* myBinding = myOperationBinding->Binding; Console::WriteLine(S" Binding : {0} :: Name of operation : {1}", myBinding->Name, myOperationBinding->Name); FaultBindingCollection* myFaultBindingCollection1 = myOperationBinding->Faults; System::Collections::IEnumerator* myEnum1 = myFaultBindingCollection1->GetEnumerator(); while (myEnum1->MoveNext()) { FaultBinding* myFaultBinding1 = __try_cast<FaultBinding*>(myEnum1->Current); Console::WriteLine(S" Fault : {0}", myFaultBinding1->Name); } } // Save the ServiceDescripition to an external file. myServiceDescription->Write(S"MathService_new_cs.wsdl"); } catch(Exception* e) { Console::WriteLine(S"Exception caught!!!"); Console::WriteLine(S"Source : {0}", e->Source); Console::WriteLine(S"Message : {0}", e->Message); } }
[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button
in the upper-left corner of the page.
Requirements
Namespace: System.Web.Services.Description
Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family
Assembly: System.Web.Services (in System.Web.Services.dll)
See Also
OperationBinding Members | System.Web.Services.Description Namespace