This documentation is archived and is not being maintained.

BindingCollection.Insert Method

Adds the specified Binding to the BindingCollection at the specified zero-based index.

[Visual Basic]
Public Sub Insert( _
   ByVal index As Integer, _
   ByVal binding As Binding _
)
[C#]
public void Insert(
 int index,
 Binding binding
);
[C++]
public: void Insert(
 int index,
 Binding* binding
);
[JScript]
public function Insert(
   index : int,
 binding : Binding
);

Parameters

index
The zero-based index at which to insert the binding parameter.
binding
The Binding to be added to the collection.

Remarks

If the number of items in the collection already equals the collection's capacity, the capacity is doubled by automatically reallocating the internal array before the new element is inserted.

If the index parameter is equal to Count, the binding parameter is added to the end of the BindingCollection.

The elements after the insertion point move down to accommodate the new element.

Example

[Visual Basic] 
' Create a new Binding for SOAP Protocol.
Dim myBinding As New Binding()
myBinding.Name = myServiceDescription.Services(0).Name + "Soap"
' Pass the name of the existing porttype 'MathServiceSoap' and the Xml targetNamespace attribute of the Descriptions tag.
myBinding.Type = New XmlQualifiedName("MathServiceSoap", myServiceDescription.TargetNamespace)
' Create SOAP Extensibility element.
Dim mySoapBinding As New SoapBinding()
' SOAP over Http.

mySoapBinding.Transport = "http://schemas.xmlsoap.org/soap/http"
mySoapBinding.Style = SoapBindingStyle.Document
' Add tag soap:binding as an extensibility element.
myBinding.Extensions.Add(mySoapBinding)
' Create OperationBindings for each of the operations defined in asmx file.
Dim addOperationBinding As OperationBinding = CreateOperationBinding("Add", myServiceDescription.TargetNamespace)
myBinding.Operations.Add(addOperationBinding)
Dim subtractOperationBinding As OperationBinding = CreateOperationBinding("Subtract", myServiceDescription.TargetNamespace)
myBinding.Operations.Add(subtractOperationBinding)
Dim multiplyOperationBinding As OperationBinding = CreateOperationBinding("Multiply", myServiceDescription.TargetNamespace)
myBinding.Operations.Add(multiplyOperationBinding)
Dim divideOperationBinding As OperationBinding = CreateOperationBinding("Divide", myServiceDescription.TargetNamespace)
myBinding.Operations.Add(divideOperationBinding)
myServiceDescription.Bindings.Insert(0, myBinding)

[C#] 
// Create a new Binding for SOAP Protocol.
Binding myBinding = new Binding();
myBinding.Name = myServiceDescription.Services[0].Name + "Soap";
// Pass the name of the existing porttype 'MathServiceSoap' and the Xml targetNamespace attribute of the Descriptions tag.
myBinding.Type = new XmlQualifiedName("MathServiceSoap",myServiceDescription.TargetNamespace);
// Create SOAP Extensibility element.
SoapBinding mySoapBinding = new SoapBinding();
// SOAP over HTTP.
mySoapBinding.Transport = "http://schemas.xmlsoap.org/soap/http";
mySoapBinding.Style = SoapBindingStyle.Document;
// Add tag soap:binding as an extensibility element.
myBinding.Extensions.Add(mySoapBinding);
// Create OperationBindings for each of the operations defined in asmx file.
OperationBinding addOperationBinding = CreateOperationBinding("Add",myServiceDescription.TargetNamespace);
myBinding.Operations.Add(addOperationBinding);
OperationBinding subtractOperationBinding = CreateOperationBinding("Subtract",myServiceDescription.TargetNamespace);
myBinding.Operations.Add(subtractOperationBinding);
OperationBinding multiplyOperationBinding = CreateOperationBinding("Multiply",myServiceDescription.TargetNamespace);
myBinding.Operations.Add(multiplyOperationBinding);
OperationBinding divideOperationBinding = CreateOperationBinding("Divide",myServiceDescription.TargetNamespace);
myBinding.Operations.Add(divideOperationBinding);
myServiceDescription.Bindings.Insert(0,myBinding);

[C++] 
// Create a new Binding for SOAP Protocol.
Binding* myBinding = new Binding();
myBinding->Name = String::Concat( myServiceDescription->Services->Item[0]->Name, S"Soap" );
// Pass the name of the existing porttype 'MathServiceSoap' and the Xml targetNamespace attribute of the Descriptions tag.
myBinding->Type = new XmlQualifiedName(S"MathServiceSoap",myServiceDescription->TargetNamespace);
// Create SOAP Extensibility element.
SoapBinding* mySoapBinding = new SoapBinding();
// SOAP over HTTP.
mySoapBinding->Transport = S"http://schemas.xmlsoap.org/soap/http";
mySoapBinding->Style = SoapBindingStyle::Document;
// Add tag soap:binding as an extensibility element.
myBinding->Extensions->Add(mySoapBinding);
// Create OperationBindings for each of the operations defined in asmx file.
OperationBinding* addOperationBinding = CreateOperationBinding(S"Add",myServiceDescription->TargetNamespace);
myBinding->Operations->Add(addOperationBinding);
OperationBinding* subtractOperationBinding = CreateOperationBinding(S"Subtract",myServiceDescription->TargetNamespace);
myBinding->Operations->Add(subtractOperationBinding);
OperationBinding* multiplyOperationBinding = CreateOperationBinding(S"Multiply",myServiceDescription->TargetNamespace);
myBinding->Operations->Add(multiplyOperationBinding);
OperationBinding* divideOperationBinding = CreateOperationBinding(S"Divide",myServiceDescription->TargetNamespace);
myBinding->Operations->Add(divideOperationBinding);
myServiceDescription->Bindings->Insert(0,myBinding);

[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also

BindingCollection Class | BindingCollection Members | System.Web.Services.Description Namespace

Show: