OperationBinding Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt Spezifikationen für Protokolle und Datenformate für die nachrichten bereit, die in der vom XML-Webdienst unterstützten Aktion verwendet werden. Diese Klasse kann nicht vererbt werden.
public ref class OperationBinding sealed : System::Web::Services::Description::DocumentableItem
public ref class OperationBinding sealed : System::Web::Services::Description::NamedItem
[System.Web.Services.Configuration.XmlFormatExtensionPoint("Extensions")]
public sealed class OperationBinding : System.Web.Services.Description.DocumentableItem
[System.Web.Services.Configuration.XmlFormatExtensionPoint("Extensions")]
public sealed class OperationBinding : System.Web.Services.Description.NamedItem
[<System.Web.Services.Configuration.XmlFormatExtensionPoint("Extensions")>]
type OperationBinding = class
inherit DocumentableItem
[<System.Web.Services.Configuration.XmlFormatExtensionPoint("Extensions")>]
type OperationBinding = class
inherit NamedItem
Public NotInheritable Class OperationBinding
Inherits DocumentableItem
Public NotInheritable Class OperationBinding
Inherits NamedItem
- Vererbung
- Vererbung
- Attribute
Beispiele
Im folgenden Beispiel wird die Verwendung der Von der OperationBinding Klasse verfügbar gemachten Eigenschaften und Methoden veranschaulicht. Es akzeptiert eine vorhandene ServiceDescription und fügt Unterstützung für das SOAP-Protokoll hinzu.
#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( "MathService_input_cs.wsdl" );
String^ myTargetNamespace = myServiceDescription->TargetNamespace;
// Create an OperationBinding for the Add operation.
OperationBinding^ addOperationBinding = gcnew OperationBinding;
String^ addOperation = "Add";
addOperationBinding->Name = addOperation;
// Create an InputBinding for the Add operation.
InputBinding^ myInputBinding = gcnew InputBinding;
SoapBodyBinding^ mySoapBodyBinding = gcnew 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 = gcnew OutputBinding;
myOutputBinding->Extensions->Add( mySoapBodyBinding );
// Add the OutputBinding to the OperationBinding.
addOperationBinding->Output = myOutputBinding;
// Create an extensibility element for a SoapOperationBinding.
SoapOperationBinding^ mySoapOperationBinding = gcnew 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 = gcnew FaultBinding;
myFaultBinding->Name = "ErrorFloat";
// Associate SOAP fault binding to the fault binding of the operation.
myExtensions = myFaultBinding->Extensions;
SoapFaultBinding^ mySoapFaultBinding = gcnew 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:" );
System::Collections::IEnumerator^ myEnum = myOperationBindingCollection->GetEnumerator();
while ( myEnum->MoveNext() )
{
OperationBinding^ myOperationBinding = safe_cast<OperationBinding^>(myEnum->Current);
Binding^ myBinding = myOperationBinding->Binding;
Console::WriteLine( " 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 = safe_cast<FaultBinding^>(myEnum1->Current);
Console::WriteLine( " Fault : {0}", myFaultBinding1->Name );
}
}
myServiceDescription->Write( "MathService_new_cs.wsdl" );
}
catch ( Exception^ e )
{
Console::WriteLine( "Exception caught!!!" );
Console::WriteLine( "Source : {0}", e->Source );
Console::WriteLine( "Message : {0}", e->Message );
}
}
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 ServiceDescription 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);
}
}
}
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
End Class
Hinweise
Die OperationBinding Klasse entspricht dem vom Element eingeschlossenen <binding> Web Services Description Language (WSDL)<operation>-Element, das wiederum der Binding Klasse entspricht. Weitere Informationen zu WSDL finden Sie in der WSDL-Spezifikation .
Konstruktoren
| Name | Beschreibung |
|---|---|
| OperationBinding() |
Initialisiert eine neue Instanz der OperationBinding-Klasse. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| Binding |
Ruft ab Binding , von dem das aktuelle OperationBinding Mitglied ist. |
| Documentation |
Ruft die Textdokumentation für die Instanz der DocumentableItem. (Geerbt von DocumentableItem) |
| DocumentationElement |
Ruft ab oder legt das Dokumentationselement für die DocumentableItem. (Geerbt von DocumentableItem) |
| ExtensibleAttributes |
Dient zum Abrufen oder Festlegen eines Arrays vom Typ XmlAttribute , das Attributerweiterungen von WSDL darstellt, um web Services Interoperability (WS-I) Basic Profile 1.1 einzuhalten. (Geerbt von DocumentableItem) |
| Extensions |
Ruft die Auflistung von Erweiterungselementen ab, die für die aktuelle .OperationBinding |
| Faults |
Ruft die FaultBindingCollection zugeordnete Instanz ab OperationBinding . |
| Input |
Dient zum Abrufen oder Festlegen des InputBinding zugeordneten mit der OperationBinding. |
| Name |
Dient zum Abrufen oder Festlegen des Namens der OperationBinding. |
| Name |
Dient zum Abrufen oder Festlegen des Namens des Elements. (Geerbt von NamedItem) |
| Namespaces |
Ruft das Wörterbuch der Namespacepräfixe und Namespaces ab, die zum Beibehalten von Namespacepräfixen und Namespaces verwendet werden, wenn ein ServiceDescription Objekt erstellt wird, oder legt es fest. (Geerbt von DocumentableItem) |
| Output |
Dient zum Abrufen oder Festlegen des OutputBinding zugeordneten mit der OperationBinding. |
Methoden
| Name | Beschreibung |
|---|---|
| Equals(Object) |
Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object) |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |