使用 Offline Application Block 進(jìn)行開發(fā)

Microsoft Corporation

內(nèi)容：第 3 章詳細(xì)說明了構(gòu)建和使用該應(yīng)用程序塊的過程。本章還提供了快速入門，以幫助您了解實現(xiàn)自己的脫機(jī)解決方案所需的步驟。

本頁內(nèi)容

	安裝 Offline Application Block
	Offline Application Block 快速入門
	使用 Offline Application Block
	開發(fā)自己的提供程序
	小結(jié)
	更多信息

現(xiàn)在您已經(jīng)了解了 Offline Application Block 的設(shè)計，接下來就可以使用該應(yīng)用程序塊開發(fā)解決方案了。要開發(fā)使用 Offline Application Block 的應(yīng)用程序，您需要：

本章為您說明了如何使用 Offline Application Block 以及與該應(yīng)用程序塊隨附的不同子系統(tǒng)相關(guān)聯(lián)的提供程序，來開發(fā)解決方案。本章還討論了設(shè)計注意事項以及如何開發(fā)自己的提供程序。本章使用連接檢測提供程序（由該應(yīng)用程序塊提供）作為參考示例。

安裝 Offline Application Block

在安裝 Offline Application Block 之前，查看軟件要求和該應(yīng)用程序塊構(gòu)建的文件夾結(jié)構(gòu)非常重要。

軟件要求

要使用 Offline Application Block，您必須確保系統(tǒng)符合下列最低軟件要求：

此外，您可能需要安裝 Microsoft Internet 信息服務(wù) (IIS)，這取決于應(yīng)用程序的目的，或是您是否打算安裝 InsuranceClaimsService Web 服務(wù)，以便在同一計算機(jī)上運行 InsuranceClaimsQuickStart\InsuranceClaimsClient。

該應(yīng)用程序塊具有用于“隊列存儲”的內(nèi)置提供程序。這些提供程序使用：

除其他提供程序之外，該應(yīng)用程序塊還具有用于緩存的內(nèi)置提供程序。

注 有關(guān)相應(yīng)隊列和緩存提供程序的配置詳細(xì)信息，請參閱本章結(jié)尾的“設(shè)置桌面引擎和 MSMQ”部分。

構(gòu)建 Offline Application Block

您必須先構(gòu)建解決方案，然后添加對幾個程序集的引用，之后才能使用 Offline Application Block。

構(gòu)建 Offline Application Block

要在應(yīng)用程序中使用 Offline Application Block，您需要添加一個對 Common、Offline Providers 和 Offline 程序集的引用。如果您使用的是 Visual C#，請將 using 指令添加到要訪問塊代碼的文件中。如果您使用的是 Visual Basic .NET，請將 Imports 指令添加到您要在其中訪問塊代碼的文件中。例如，如果您使用 Visual C# 編寫一個新的服務(wù)代理，請將以下 using 指令添加到要訪問塊代碼的文件中：

...
using Microsoft.ApplicationBlocks.SmartClient.Offline;
...
  

在 Visual Basic 中使用的相應(yīng) Imports 指令是：

...
Imports Microsoft.ApplicationBlocks.SmartClient.Offline
...
  

Offline Application Block 文件夾結(jié)構(gòu)

當(dāng)您安裝 Offline Application Block 時，安裝程序包將創(chuàng)建以下文件夾結(jié)構(gòu)：

<Install Location>
+---Offline
    +---Caching
    :   +---src
    :       +---cs
    :           +---Cache
    :           :   +---DataProtectionImplementations
    :           :   +---ExpirationsImplementations
    :           :   +---ScavengingImplementations
    :           :   +---StorageImplementations
    :           +---MemoryMappedFile
    +---Common
    :   +---src
    :       +---cs
    :           +---Common
    :           :   +---Crypto
    :           :   :   +---doc
    :           :   +---doc
    :           +---Version
    +---DAAB
    :   +---src
    :       +---cs
    :           +---Microsoft.ApplicationBlocks.Data
    +---Database
    :   +---Cache
    :   +---Queue
    +---Docs
    +---EMAB
    :   +---src
    :       +---cs
    :           +---Microsoft.ApplicationBlocks.ExceptionManagement
    :           +---Microsoft.ApplicationBlocks.ExceptionManagement.Interfaces
    +---QuickStarts
    :   +---src
    :   :   +---cs
    :   :   :   +---ConnectionManagementQuickStart
    :   :   :   +---DownloadQuickStart
    :   :   :   +---InsuranceClaimsQuickStart
    :   :   :   :   +---Database
    :   :   :   :   +---InsuranceClaimsClient
    :   :   :   :   +---InsuranceClaimsService
    :   :   :   +---UploadQuickStart
    :   :   +---vb
    :   :       +---ConnectionManagementQuickStart
    :   :       +---DownloadQuickStart
    :   :       +---InsuranceClaimsQuickStart
    :   :       :   +---Database
    :   :       :   +---InsuranceClaimsClient
    :   :       :   +---InsuranceClaimsService
    :   :       +---UploadQuickStart
    :   +---Utility
    :       +---ValidationKeyGeneration
    +---src
        +---cs
            +---Offline
            :   +---Builders
            :   +---ConnectionManagement
            :   +---DataLoadingManagement
            :   +---Executor
            :   +---QueueManagement
            :   +---ReferenceDataManagement
            :   +---ServiceAgentManagement
            +---Offline Providers
            :   +---CacheStorageProviders
            :   +---ConnectionDetectionStrategies
            :   +---QueueStorageProviders
            +---Versioning

每個快速入門解決方案都構(gòu)建在各自的子文件夾中。表 3.1 說明了在安裝 Offline Application Block 時安裝程序包所創(chuàng)建的文件夾。

表 3.1：Offline Application Block 安裝程序包創(chuàng)建的文件夾

返回頁首

Offline Application Block 快速入門

要將脫機(jī)功能添加到應(yīng)用程序中，請先查看該應(yīng)用程序塊隨附的四個快速入門：

您可以使用這些快速入門來更好地理解 Offline Application Block、開發(fā)新的提供程序或修改現(xiàn)有的提供程序。例如，您可能要為連接檢測功能開發(fā)幾個提供程序，但在配置文件中只啟用所需的提供程序。

要點 這些快速入門旨在幫助您理解該應(yīng)用程序塊；它們不是現(xiàn)成的產(chǎn)品代碼示例。

下面的段落將在開發(fā)人員要在應(yīng)用程序中執(zhí)行的任務(wù)的上下文中討論每個快速入門。

管理應(yīng)用程序的連接狀態(tài)

“連接管理快速入門”說明如何使用該應(yīng)用程序塊的“連接狀態(tài)管理”子系統(tǒng)組件，來檢測應(yīng)用程序是處于聯(lián)機(jī)狀態(tài)還是脫機(jī)狀態(tài)，以及強(qiáng)制改變應(yīng)用程序的狀態(tài)。

該快速入門的單屏幕中包含兩個按鈕 — Go Offline 和 Go Online，可讓用戶將應(yīng)用程序的狀態(tài)更改為聯(lián)機(jī)或脫機(jī)。該屏幕還有一個標(biāo)簽，用來顯示應(yīng)用程序的連接狀態(tài)。

當(dāng)該快速入門運行時，應(yīng)用程序塊開始在后臺輪詢連接，以自動檢測連接狀態(tài)更改。如果連接狀態(tài)隨后被強(qiáng)制為脫機(jī)，則輪詢會立即停止。該快速入門注冊了 ConnectionManager 類的 ConnectionStateChangedEvent。注冊該事件可讓快速入門對連接狀態(tài)的更改做出反應(yīng)。當(dāng)連接狀態(tài)更改時，會引發(fā)該事件，并且屏幕上的連接狀態(tài)標(biāo)簽會發(fā)生更改，以反映應(yīng)用程序的連接狀態(tài)。

構(gòu)建連接管理快速入門

要啟動該快速入門，請雙擊 ConnectionManagerQuickStart.exe。

“連接管理快速入門”文件

這些快速入門文件位于 <installation location>\Offline\QuickStarts\src\<language>\ConnectionManagementQuickStart\ 文件夾中。表 3.2 說明了與該“連接管理快速入門”討論相關(guān)的文件。

表 3.2：“連接管理快速入門”文件

詳細(xì)信息

該快速入門使用了該應(yīng)用程序塊隨附的默認(rèn)連接檢測提供程序（策略）。該默認(rèn)連接檢測提供程序使用 WinInet 動態(tài)鏈接庫 (DLL) 的 InternetGetConnectedState 方法來檢測連接狀態(tài)更改。例如，如果在運行該示例時，將網(wǎng)絡(luò)電纜從連接到網(wǎng)絡(luò)的計算機(jī)中拔出，則連接狀態(tài)將顯示更改為脫機(jī)模式。

檢測連接的提供程序是在應(yīng)用程序配置文件中指定的。有關(guān)在配置文件中指定提供程序的詳細(xì)信息，請參閱第 4 章“Offline Application Block 配置和安全注意事項”。

傳輸中的數(shù)據(jù)：下載

“下載快速入門”說明如何下載參考數(shù)據(jù)，以便應(yīng)用程序的用戶即使在應(yīng)用程序脫機(jī)時也可以繼續(xù)使用該應(yīng)用程序。

該快速入門的單屏幕中包含一個 Download 按鈕和一個用來顯示結(jié)果的網(wǎng)格。當(dāng)用戶單擊 Download 按鈕時，數(shù)據(jù)開始下載（從本地的 XML 文件讀取）并顯示在網(wǎng)絡(luò)中。

構(gòu)建下載快速入門

要啟動該快速入門，請雙擊 DownloadQuickStart.exe。

“下載快速入門”文件

這些快速入門文件位于 <installation location>\Offline\QuickStarts\src\<language>\DownloadQuickStart\ 文件夾中。表 3.3 說明了與該“下載快速入門”討論相關(guān)的文件。

表 3.3：“下載快速入門”文件

詳細(xì)信息

該快速入門使用服務(wù)代理（DownloadDataServiceAgent）來啟動下載。DownloadDataServiceAgent 負(fù)責(zé)使用必要的上下文信息創(chuàng)建正確的 ReferenceDataDefinition，例如使用 OnlineProxyContext 創(chuàng)建 OnlineProxy 類以便從虛擬服務(wù)（為進(jìn)行說明而使用的一個本地方法調(diào)用）中檢索數(shù)據(jù)，以及使用 ServiceAgentContext 將結(jié)果返回到控制器。該服務(wù)代理調(diào)用 DataLoaderManager 來啟動下載具有正確 ReferenceDataDefinition 值的參考數(shù)據(jù)。

OnlineProxy 負(fù)責(zé)檢索數(shù)據(jù)，然后使用“參考數(shù)據(jù)管理”子系統(tǒng)將該數(shù)據(jù)存儲在“參考數(shù)據(jù)緩存”中。

默認(rèn)情況下，該快速入門使用 InMemoryQueueStorageProvider 來緩存數(shù)據(jù)。用于緩存的提供程序是在應(yīng)用程序的配置文件中指定的。有關(guān)如何在配置文件中指定提供程序的詳細(xì)信息，請參閱第 4 章“Offline Application Block 配置和安全注意事項”。

傳輸中的數(shù)據(jù)：上載

“上載快速入門”說明如何將應(yīng)用程序用戶修改后的數(shù)據(jù)上載到服務(wù)器。該快速入門說明了如何使用該應(yīng)用程序塊的“消息數(shù)據(jù)管理”子系統(tǒng)。

該快速入門的基本窗體包含幾個字段、一個 Save 按鈕和一個 Cancel 按鈕。當(dāng)該快速入門啟動時，它會讀取包含數(shù)據(jù)的本地 XML 文件，并在窗體中顯示數(shù)據(jù)。當(dāng)用戶修改數(shù)據(jù)并單擊 Save 按鈕后，該數(shù)據(jù)會保存到本地 XML 文件中。這模擬了使用與遠(yuǎn)程服務(wù)進(jìn)行通信時所必需的所有組件。

構(gòu)建上載快速入門

要啟動該快速入門，請雙擊 UploadQuickStart.exe。

“上載快速入門”文件

該快速入門文件位于 <installation location>\Offline\QuickStarts\src\<language>\UploadQuickStart\ 文件夾中。表 3.4 說明了與該“上載快速入門”討論相關(guān)的文件。

表 3.4：“上載快速入門”文件

詳細(xì)信息

該快速入門說明了“消息數(shù)據(jù)管理”子系統(tǒng)是如何工作的。當(dāng)該快速入門啟動時，它從本地 XML 文件中讀取數(shù)據(jù)，并將數(shù)據(jù)顯示在窗體中。在用戶修改數(shù)據(jù)后單擊 Save 按鈕時，控制器將調(diào)用 UploadDataServiceAgent 對象的 UpdateWorkItem 方法。

UploadDataServiceAgent 對象可創(chuàng)建處理請求和提供必要上下文信息（例如 OnlineProxyContext 和 ServiceAgentContext 對象）所需的 Payload 對象。

創(chuàng)建 payload 后，UploadDataServiceAgent 對象會將它存儲在隊列中。Executor 對象從隊列中提取 payload，然后調(diào)用 OnlineProxy 對象來處理請求。

OnlineProxy 對象將更新本地 XML 文件中的數(shù)據(jù)。它還可以將該信息傳達(dá)到某個服務(wù)。它使用 ServiceAgentContext 對象將結(jié)果返回到控制器。

默認(rèn)情況下，該快速入門使用 InMemoryQueueStorageProvider 來排隊消息。用于排隊的提供程序是在應(yīng)用程序的配置文件中指定的。有關(guān)如何在配置文件中指定提供程序的詳細(xì)信息，請參閱第 4 章“Offline Application Block 配置和安全注意事項”。

綜合的端到端解決方案

“保險理賠快速入門”將本章前面部分和第 2 章中討論的所有概念結(jié)合在一起。該快速入門說明了一個使用 Web 服務(wù)運行在服務(wù)器（也可以是本地計算機(jī)）上并提供業(yè)務(wù)功能的端到端應(yīng)用程序。

注 默認(rèn)情況下，在安裝該快速入門解決方案時，創(chuàng)建虛擬目錄的 Web 服務(wù)對象和腳本都會包含在其中。該腳本將在同一臺計算機(jī)上創(chuàng)建 Web 服務(wù)。作為一種備選方法，為了模擬更加真實的情形，您可以在其他計算機(jī)上創(chuàng)建 Web 服務(wù)。為此，您必須對解決方案文件進(jìn)行適當(dāng)?shù)母模瑫r也要更改 Web 參考。

該快速入門包括兩個部分：保險理賠客戶端（智能客戶端應(yīng)用程序）和保險理賠服務(wù)（Web 服務(wù)）。

該客戶端為智能客戶端應(yīng)用程序，它能夠在脫機(jī)模式下工作。Web 服務(wù)能夠?qū)I(yè)務(wù)功能作為 Web 方法公開。

該用戶界面是單個屏幕，它結(jié)合了前面的快速入門中說明的所有用戶界面。屏幕上包含多個按鈕，可用于強(qiáng)制應(yīng)用程序聯(lián)機(jī)或脫機(jī)，下載工作項目，以及保存在應(yīng)用程序聯(lián)機(jī)時要上載的工作項目。該快速入門使用了 Offline Application Block 的所有子系統(tǒng)。

您必須先創(chuàng)建 Web 服務(wù)和該 Web 服務(wù)所使用的數(shù)據(jù)庫，然后才能構(gòu)建該快速入門。

創(chuàng)建保險理賠 Web 服務(wù)及其使用的數(shù)據(jù)庫

請注意，您必須在安裝有 Web 服務(wù)的計算機(jī)上執(zhí)行前面的步驟。

要點 默認(rèn)情況下，MSDE 使用 Windows 身份驗證作為其登錄模式。Web 服務(wù)運行在名為 ASPNET 的默認(rèn)用戶下，您必須先授予該用戶權(quán)限并對其進(jìn)行配置，然后才能有效地使用 MSDE。有關(guān)如何授予權(quán)限和配置帳戶的說明，請參閱 .NET Framework SDK QuickStart Configuration Details 文檔。默認(rèn)情況下，該文檔位于：<運行 Visual Studio .NET 的計算機(jī)的 drive:\>Program Files\Microsoft Visual Studio .NET 2003\SDK\v1.1\Samples\Setup\html\ConfigDetails.htm。

但是，如果要將身份驗證從 Windows 模式更改為混合模式，您必須將以下注冊表項中的 LoginMode 十六進(jìn)制值從 1 更改為 2： My Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server\VSDOTNET\MSSQLServer。

在創(chuàng)建 Web 服務(wù)和數(shù)據(jù)庫后，請使用下列步驟來構(gòu)建快速入門。

構(gòu)建“保險理賠快速入門”

要啟動該快速入門，請雙擊 InsuranceClaimsQuickStart.exe。

“保險理賠快速入門”文件

該快速入門的解決方案位于 <installationlocation>\Offline\QuickStarts\src\<language>\ InsuranceClaimsQuickStart\InsuranceClaimsClient\ 文件夾中。表 3.4 和 3.5 說明了與該“保險理賠快速入門”討論相關(guān)的文件。

表 3.4：“保險理賠快速入門”文件

表 3.5：保險理賠服務(wù)的 Web 服務(wù)文件

詳細(xì)信息

有關(guān)如何執(zhí)行特定操作的信息，請參閱前面快速入門的詳細(xì)信息。例如，前面快速入門中的詳細(xì)信息說明了下載或上載工作項目所涉及的組件。

前面的快速入門和此快速入門的唯一不同之處在于 OnlineProxy 類的行為。要使這些快速入門保持在一個基本水平，前面快速入門中的 OnlineProxy 類要在本地檢索或更新數(shù)據(jù)。在這種情況下，該快速入門將與 Web 服務(wù)進(jìn)行交互，并演示了一個使用 Offline Application Block 的應(yīng)用程序的端到端方案。

返回頁首

使用 Offline Application Block

在使用 Offline Application Block 之前，您應(yīng)評估現(xiàn)有的提供程序，并確定是否要使用它們或創(chuàng)建新的提供程序。

根據(jù)應(yīng)用程序的要求評估提供程序

當(dāng)您要將脫機(jī)功能添加到應(yīng)用程序時，必須根據(jù)下列提供程序來確定應(yīng)用程序的要求：

加密提供程序– Common Block 提供了 Data Protection API 作為其加密提供程序。您應(yīng)根據(jù)組織的安全性要求來評估該提供程序是否適合您的應(yīng)用程序體系結(jié)構(gòu)。如果不適合，您需要創(chuàng)建一個自定義提供程序。

有關(guān)在應(yīng)用程序中使用提供程序或開發(fā)自己的自定義提供程序的信息，請參閱本章后面的“開發(fā)自己的提供程序”。

使用 Offline Block 的任務(wù)

在設(shè)計階段，您的組織會決定 Offline Application Block 要滿足的業(yè)務(wù)要求。某些要求會涉及到用戶界面 (UI) 和用戶界面控制器 (UIC)。這些用戶界面依賴于您組織所提出的業(yè)務(wù)要求，并決定聯(lián)機(jī)/脫機(jī)操作與用戶之間的交互。有關(guān) UIC 和用戶界面處理 (UIP) 的討論超出了本指南的范圍。

下表向您展示了在構(gòu)建具有脫機(jī)功能的應(yīng)用程序時，可能要執(zhí)行的常見任務(wù)。

開始

開始訪問脫機(jī)功能

...
private OfflineBlockBuilder offlineBlockBuilderInstance;
    offlineBlockBuilderInstance = OfflineBlockBuilder.Instance;
...
  

...
Private OfflineBlockBuilder offlineBlockBuilderInstance
    offlineBlockBuilderInstance = OfflineBlockBuilder.Instance
...
  

...
offlineBlockBuilderInstance.ConnectionManager.ConnectionState ChangedEvent += new ConnectionStateChangedEventHandler(ConnectionManager
        ConnectionStateChangedEvent);
...
  

...
    offlineBlockBuilderInstance AddHandler offlineBlockBuilderInstance.ConnectionManager.ConnectionStateChangedEvent, AddressOf ConnectionManagerConnectionStateChangedEvent
...
  

...
FailsafeServiceAgent refFailSafeServiceAgent = offlineBlockBuilderInstance.FailsafeServiceAgent;
refFailSafeServiceAgent.ErrorEvent += new MethodExecutionFailureReportEventHandler(
FailSafeServiceAgentErrorEvent);
...
  

...
Dim refFailSafeServiceAgent As FailsafeServiceAgent = offlineBlockBuilderInstance.FailsafeServiceAgent
            AddHandler refFailSafeServiceAgent.ErrorEvent, AddressOf FailSafeServiceAgentErrorEvent
...
  

...
offlineBlockBuilderInstance.Start() ;
...
  

...
offlineBlockBuilderInstance = OfflineBlockBuilder.Start
...
  

...
offlineBlockBuilderInstance.ConnectionManager.GoOffline() ;
...
  

...
offlineBlockBuilderInstance.ConnectionManager.GoOffline()
...
  

...
offlineBlockBuilderInstance.ConnectionManager.GoOnline() ;
...
  

...
offlineBlockBuilderInstance.ConnectionManager.GoOnline()
...
  

使用“應(yīng)用程序服務(wù)代理”中的 DataLoaderManager 將數(shù)據(jù)加載到客戶端數(shù)據(jù)存儲區(qū)中

以下代碼闡釋了前面的步驟：

[C#]

...
string onlineProxyAssemblyName = "InsuranceClaimsClient";
string onlineProxyClassName = "Microsoft.ApplicationBlocks.SmartClient.Offline.QuickStarts.OnlineProxy";
string onlineProxyMethodName ="GetWorkItems";
string specificServiceAgentMethodTobeInvoked = "DataAvailableCallBack";
const int absoluteExpirationTime = 600;
string cacheKey = "SmartClient";
OnlineProxyContext onlineProxyMethodContext = 
    new OnlineProxyContext(onlineProxyAssemblyName, 
    onlineProxyClassName, onlineProxyMethodName);
ServiceAgentContext specificServiceAgentContext = new 
    ServiceAgentContext(specificServiceAgentMethodTobeInvoked);
ReferenceDataDefinition refDataDefination = new 
    ReferenceDataDefinition(cacheKey, absoluteExpirationTime, 
    onlineProxyMethodContext);
offlineBlockBuilderInstance.DataLoaderManager.LoadData(this.Guid, 
    specificServiceAgentContext, refDataDefination);
...
  

[Visual Basic]

...
Dim onlineProxyAssemblyName As String = "InsuranceClaimsClient"
Dim onlineProxyClassName As String = 
"Microsoft.ApplicationBlocks.SmartClient.Offline.QuickStarts.OnlineProxy"
Dim onlineProxyMethodName As String = "GetWorkItems"
Dim specificServiceAgentMethodTobeInvoked As String = 
    "DataAvailableCallBack"
Const absoluteExpirationTime As Integer = 600
Dim cacheKey As String = "SmartClient"
Dim onlineProxyMethodContext As New 
    OnlineProxyContext(onlineProxyAssemblyName, onlineProxyClassName, 
    onlineProxyMethodName)
Dim specificServiceAgentContext As New 
    ServiceAgentContext(specificServiceAgentMethodTobeInvoked)
Dim refDataDefination As New ReferenceDataDefinition(cacheKey, 
    absoluteExpirationTime, onlineProxyMethodContext)
offlineBlockBuilderInstance.DataLoaderManager.LoadData(Me.Guid, 
    specificServiceAgentContext, refDataDefination)
...
  

使用“應(yīng)用程序服務(wù)代理”中的 QueueManager 將數(shù)據(jù)排入隊列

以下代碼闡釋了前面的步驟：

[C#]

...
string onlineProxyAssemblyName = "InsuranceClaimsClient";
string onlineProxyClassName = "Microsoft.ApplicationBlocks.SmartClient.Offline.QuickStarts.OnlineProxy";
string onlineProxyMethodName ="UpdateWorkItem";
string specificServiceAgentMethodTobeInvoked = "DataUpdatedCallBack";
OnlineProxyContext onlineProxyMethodContext = new 
    OnlineProxyContext(onlineProxyAssemblyName, onlineProxyClassName, 
    onlineProxyMethodName);
ServiceAgentContext specificServiceAgentContext = new 
    ServiceAgentContext(specificServiceAgentMethodTobeInvoked);
Payload messageToEnqueue = new 
    Payload(onlineProxyMethodContext,this.Guid,
    specificServiceAgentContext, changedAppData);
offlineBlockBuilderInstance.PayloadConsumer.Enqueue(messageToEnqueue);
...
  

[Visual Basic]

...
Dim onlineProxyAssemblyName As String = "InsuranceClaimsClient"
Dim onlineProxyClassName As String = "Microsoft.ApplicationBlocks.SmartClient.Offline.QuickStarts.OnlineProxy"
Dim onlineProxyMethodName As String = "UpdateWorkItem"
Dim specificServiceAgentMethodToInvoke As String = "DataUpdatedCallBack"
Dim onlineProxyMethodContext As New OnlineProxyContext(onlineProxyAssemblyName, onlineProxyClassName, onlineProxyMethodName)
Dim specificServiceAgentContext As New ServiceAgentContext(specificServiceAgentMethodToInvoke)
Dim messageToEnqueue As New Payload(onlineProxyMethodContext, _
    Me.Guid, specificServiceAgentContext, _
    changedAppData)
offlineBlockBuilderInstance.PayloadConsumer.Enqueue(messageToEnqueue)

返回頁首

開發(fā)自己的提供程序

至此，本章的重點一直是如何在不加修改的情況下將 Offline Application Block 用于您的應(yīng)用程序。設(shè)計的關(guān)鍵方面在于，您可以利用自己的提供程序來擴(kuò)展應(yīng)用程序塊。這些注意事項適用于您創(chuàng)建的任何提供程序。

開發(fā)自己的提供程序

WinInetDetectionStrategy 提供程序說明了以前的設(shè)計注意事項如何表示“連接管理”子系統(tǒng)用于連接檢測的連接檢測提供程序。

WinInetDetectionStrategy 提供程序?qū)崿F(xiàn) IConnectionDetectionStrategy 和 IProvider 接口。這些提供程序的配置設(shè)置在 ConnectionManagerProviders 區(qū)段中被定義為 provider 元素，其 name 特性設(shè)置為 winINetDetectionStrategy。通用屬性被指定為特性，而自定義屬性 pollingInterval 被指定為 provider 元素的子元素。ConnectionManagerConfigurator 類可讀取配置信息，并創(chuàng)建該提供程序的一個實例。

設(shè)置 MSDE 和 MSMQ

在通過這些快速入門或任何自定義應(yīng)用程序使用 MSDE 和 MSMQ 提供程序之前，您需要相應(yīng)地設(shè)置 MSDE 和 MSMQ。

MSDE 設(shè)置

在將 MSDE 提供程序用于緩存或隊列之前，您必須配置 MSDE，以使其在客戶端計算機(jī)上正常工作。有關(guān)詳細(xì)信息，請參閱 <drive:\ >Program Files\Microsoft Visual Studio .NET 2003\SDK\v1.1\Samples\Setup\html\ConfigDetails.htm。

要配置 MSDE 提供程序以用于緩存，您必須創(chuàng)建該緩存塊所使用的必要表格和存儲過程。

創(chuàng)建表格和過程

在將 MSDE 提供程序用于隊列時，您必須創(chuàng)建“消息數(shù)據(jù)管理”子系統(tǒng)所使用的必要數(shù)據(jù)庫。

創(chuàng)建數(shù)據(jù)庫

消息隊列

在將 MSMQ 提供程序用于隊列之前，您必須在本地計算機(jī)上配置“消息隊列”。有關(guān)詳細(xì)信息，請參閱 Microsoft Message Queuing (MSMQ) Center (http://www.Microsoft.com/windows2000/technologies/communications/msmq/default.asp)

如果不存在隊列，Offline Application Block 將創(chuàng)建一個。建議您在使用消息隊列提供程序之前，手動創(chuàng)建一個隊列。這可讓您根據(jù)組織的安全要求來靈活地配置“消息隊列”。以下步驟說明如何手動創(chuàng)建隊列。

手動創(chuàng)建專用隊列

有關(guān)部署要求和注意事項的詳細(xì)信息，請參閱第 4 章。

返回頁首

小結(jié)

Offline Application Block 為您提供了可用于將脫機(jī)功能添加到應(yīng)用程序的靈活設(shè)計和基礎(chǔ)結(jié)構(gòu)。在許多情況下，您可以將隨附的提供程序用于子系統(tǒng)。在某些情況下，您需要自定義這些提供程序或創(chuàng)建自己的提供程序。Offline Application Block 提供的這些快速入門為您提供了理解如何使用該應(yīng)用程序塊的有用起點。

返回頁首

更多信息

有關(guān) MSDE 的詳細(xì)信息，請參閱“Distributing the SQL Server Desktop Engine”。

有關(guān) SQL Server 的詳細(xì)信息，請參閱 SQL Server。

有關(guān)消息隊列的詳細(xì)信息，請參閱“Message Queuing (MSMQ) ”？

有關(guān) DPAPI 的詳細(xì)信息，請參閱 Windows Data Protection。

轉(zhuǎn)到原英文頁面