LogicalMethodInfo::BeginInvoke Method (Object^, array<Object^>^, AsyncCallback^, Object^)

 

Begins an asynchronous invocation of the method represented by this LogicalMethodInfo.

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

public:
[PermissionSetAttribute(SecurityAction::LinkDemand, Name = "FullTrust")]
IAsyncResult^ BeginInvoke(
	Object^ target,
	array<Object^>^ values,
	AsyncCallback^ callback,
	Object^ asyncState
)

Parameters

target
Type: System::Object^

The instance of the Object on which to invoke the method on.

values
Type: array<System::Object^>^

An argument list for the invoked method. This is an array of objects with the same number, order, and type as the parameters of the method. If the method does not require any parameters, values should be null.

callback
Type: System::AsyncCallback^

The delegate to call when the asynchronous invoke is complete. If callback is null, the delegate is not called.

asyncState
Type: System::Object^

State information that is passed on to the delegate.

Return Value

Type: System::IAsyncResult^

An IAsyncResult which is passed to EndInvoke to obtain the return values from the remote method call.

Exception Condition
TargetException

The target parameteris null.

ArgumentException

The number, type, and order of parameters in values do not match the signature of the invoked method.

MemberAccessException

The caller does not have permission to invoke the method.

public:
   [PermissionSet(SecurityAction::Demand, Name="FullTrust")]
   static void main()
   {
      // Get the type information.
      // Note: The MyMath class is a proxy class generated by the Wsdl.exe
      // utility for the Math Web service. This class can also be found in
      // the SoapHttpClientProtocol class example.
      Type^ myType = MyMath::MyMath::typeid;

      // Get the method info.
      MethodInfo^ myBeginMethod = myType->GetMethod( "BeginAdd" );
      MethodInfo^ myEndMethod = myType->GetMethod( "EndAdd" );

      // Create an instance of the LogicalMethodInfo class.
      array<MethodInfo^>^ temp0 = { myBeginMethod, myEndMethod };
      LogicalMethodInfo^ myLogicalMethodInfo =
         ( LogicalMethodInfo::Create( temp0, LogicalMethodTypes::Async ) )[ 0 ];

      // Get an instance of the proxy class.
      MyMath::MyMath^ myMathService = gcnew MyMath::MyMath;

      // Call the MyEndIntimationMethod method to intimate the end of
      // the asynchronous call.
      AsyncCallback^ myAsyncCallback = gcnew AsyncCallback( MyEndIntimationMethod );

      // Begin to invoke the Add method.
      array<Object^>^ temp1 = { 10, 10 };
      IAsyncResult^ myAsyncResult = myLogicalMethodInfo->BeginInvoke(
         myMathService, temp1, myAsyncCallback, nullptr );

      // Wait until invoke is complete.
      myAsyncResult->AsyncWaitHandle->WaitOne();

      // Get the result.
      array<Object^>^ myReturnValue;
      myReturnValue = myLogicalMethodInfo->EndInvoke( myMathService, myAsyncResult );

      Console::WriteLine( "Sum of 10 and 10 is {0}", myReturnValue[ 0 ] );
   }

   // This method will be called at the end of the asynchronous call.
   static void MyEndIntimationMethod( IAsyncResult^ /*Result*/ )
   {
      Console::WriteLine( "Asynchronous call on Add method finished." );
   }

.NET Framework
Available since 1.1
Return to top
Show: