Working with the RAPI Class
為了簡化RAPI類的操作，我將添加一個using聲明到示例程序的C#版本，或添加一個Imports聲明到VB.NET中，示例如下：

[VC#.NET]
using OpenNETCF.Desktop.Communication;
[VB.NET]
Imports OpenNETCF.Desktop.Communication
另外，我將添加一個單獨的module-level變量，myrapi，用于保存一個RAPI類的實例。

[VC#.NET]
// Declare an instance of the RAPI object.
RAPI myrapi;
[VB.NET]
' Declare an instance of the RAPI object.
Dim WithEvents myrapi As New rapi
Connecting to the Device
當你的桌面程序使用RAPI類時，第一步是要與設備建立一個連接。

注意：在桌面程序中使用RAPI必須要有一個PC與設備之間的激活的ActiveSync連接。

在這篇文章包含的示例程序中，在Form_Load事件中將連接到設備。為了連接到設備，你使用RAPI類的Connect方法。正如下面代碼所演示的，我緊接著檢查了RAPI類的DevicePresent屬性，來校驗連接是否成功。

[VC#.NET]
try

// Connect to the device.
{
myrapi.Connect();
while (! myrapi.DevicePresent)
{
MessageBox.Show("Please connect your device to your PC using
ActiveSync and before clicking the OK button.",
"No Device Present");
myrapi.Connect();
}
}

catch (Exception ex)
{
MessageBox.Show("The following error occurred while attempting
to connect to"+ " your device - " + ex.Message,
"Connection Error");
Application.Exit();
}
[VB.NET]
Try
' Connect to the device.
myrapi.Connect()
Do While Not myrapi.DevicePresent
MessageBox.Show("Please connect your device to your PC using
ActiveSync and " & _
"before clicking the OK button.", "No Device Present")
myrapi.Connect()
Loop

Catch ex As Exception
MessageBox.Show("The following error occurred while attempting to
connect to" & _
" your device - " & ex.Message, "Connection Error")
Application.Exit()
End Try
在連接確定后，我們將準備來探索RAPI提供的功能了。我們將從在你的桌面程序中如何管理設備的文件夾和文件開始。

Working with Files
RAPI提供了很多的功能為了操作文件夾中的文件。我將選擇示范三個文件相關的屬性：從設備上拷入、拷出文件，在設備上移動文件，在設備上刪除文件。我們先來看一下拷貝文件。

Copying Files To and From a Device
與設備交換數(shù)據(jù)最容易的方式之一就是簡單地在設備與PC間拷貝一個文本或者XML文件。該操作的使用RAPI示例程序的界面如圖一。文本和基于XML的文件可以在移動應用程序中作為存儲應用程序數(shù)據(jù)或配制數(shù)據(jù)的簡單方式。


Figure 1. The Copy File tab of the RAPI demo program.

OpenNETCF.Desktop.Communication命名空間RAPI類提供了兩個方法來拷貝文件——CopyFileToDevice 和 CopyFileFromDevice。這兩個方法都將源文件作為第一個參數(shù)，而目的文件作為第二個參數(shù)。

BtnCopyPerform按鈕的點擊事件處理過程里演示了這些方法。究竟是CopyFileToDevice 或者 CopyFileFromDevice方法被調(diào)用，要依賴于用戶通過用戶界面上的Combo Box進行選擇。

[VC#.NET]
private void btnCopyPerform_Click(object sender, System.EventArgs e)
{

// Perform the copy.
try
{
if ((txtCopySource.Text == "") (txtCopyDestination.Text == ""))
{
MessageBox.Show("You must provide both a source and destination
file.",
"Missing File Information");
}
else
{
switch (cmbCopyDirection.Text)
{
case "":
MessageBox.Show("You must select a direction before initiating
the copy.",
"No Destination Selected");
break;
case "from desktop to device":
myrapi.CopyFileToDevice(txtCopySource.Text,
txtCopyDestination.Text);
MessageBox.Show("Your file has been copied.", "Copy Success");
break;
case "from device to desktop":