PowerTCP Mail for .NET
Invoke Class
Members  Example  See Also  Send comments on this topic.
Dart.PowerTCP.Mail Namespace : Invoke Class




Presents the results from an Internet protocol Request/Response pair.

Object Model

Invoke ClassResponse Class

Syntax

Visual Basic (Declaration) 
Public Class Invoke 
Visual Basic (Usage)Copy Code
Dim instance As Invoke
C# 
public class Invoke 
Managed Extensions for C++ 
public __gc class Invoke 
C++/CLI 
public ref class Invoke 

Example

The following example demonstrates using Invoke to send a command.
Visual BasicCopy Code
' Set server and user properties. This will allow us to call other
' Ftp Component methods with the log in taking place "behind the scenes"
Ftp1.Server = "MyFTPServer"
Ftp1.Username = "blah"
Ftp1.Password = "mypass"

' Invoke a command
Dim invoke as Dart.PowerTCP.Ftp.Invoke
Try
   invoke = Ftp1.Invoke(FtpCommand.NoOp)
Catch ex as Exception
   Debug.WriteLine("Error: " + ex.Message)
   Exit Sub
End Try
            
' Success
Debug.WriteLine("Request/Response messages: " + invoke.ToString())
C#Copy Code
// Set server and user properties. This will allow us to call other
// Ftp Component methods with the log in taking place "behind the scenes"
ftp1.Server = "MyFTPServer";
ftp1.Username = "blah";
ftp1.Password = "mypass";

// Invoke a command
Dart.PowerTCP.Ftp.Invoke invoke;
try
{
   invoke = ftp1.Invoke(Dart.PowerTCP.Ftp.FtpCommand.NoOp);
}
catch (Exception ex)
{
    Debug.WriteLine("Error: " + ex.ToString());
    return;
}

// Success
Debug.WriteLine("Request/Response messages: " + invoke.ToString());

Remarks

Many Internet protocols are based on a request/reply system, where the client sends a request, and the server sends at least one reply. This continues lock-step until communication is complete. The Invoke object encapsulates these request/reply pairs.

In PowerTCP commands are often sent using the Object.Invoke or Object.BeginInvoke methods. When a command is sent an Invoke object is returned describing both the request and response. The response is encapsulated by the Invoke.Response property, which allows easy access to the raw and parsed response from the server. The request is represented by the Invoke.Request property, a string containing the request sent.

Inheritance Hierarchy

System.Object
   Dart.PowerTCP.Mail.Invoke

Requirements

Target Platforms: Microsoft .NET Framework 2.0

See Also

Documentation Version 3.2
© 2010 Dart Communications. All Rights Reserved.