IFileChangeNotificationSystem.StartMonitoring 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
向主機環境註冊要監控的檔案路徑。
public:
void StartMonitoring(System::String ^ filePath, System::Runtime::Caching::OnChangedCallback ^ onChangedCallback, [Runtime::InteropServices::Out] System::Object ^ % state, [Runtime::InteropServices::Out] DateTimeOffset % lastWriteTime, [Runtime::InteropServices::Out] long % fileSize);
public void StartMonitoring (string filePath, System.Runtime.Caching.OnChangedCallback onChangedCallback, out object state, out DateTimeOffset lastWriteTime, out long fileSize);
abstract member StartMonitoring : string * System.Runtime.Caching.OnChangedCallback * obj * DateTimeOffset * int64 -> unit
Public Sub StartMonitoring (filePath As String, onChangedCallback As OnChangedCallback, ByRef state As Object, ByRef lastWriteTime As DateTimeOffset, ByRef fileSize As Long)
參數
- filePath
- String
要監控變更之目錄或檔案的完整實體路徑。
- onChangedCallback
- OnChangedCallback
一個實作 OnChangedCallback 委派之方法的參考。 當監控的檔案或目錄變更時,主機環境的 IFileChangeNotificationSystem 介面實作會呼叫 OnChangedCallback 類別來引發事件。
- state
- Object
由主機環境提供的狀態。 快取實作和自訂變更監視器應該將狀態值視為不透明。 但是必須儲存狀態,以便在快取實作呼叫 StopMonitoring(String, Object) 方法時,能夠將狀態傳送至主機環境。
- lastWriteTime
- DateTimeOffset
這個方法回傳後,會包含 filePath
位置上一次發生寫入作業的日期和時間。 這個參數會以未初始化的狀態傳遞。 主機環境會傳回此參數。
- fileSize
- Int64
這個方法回傳後,會包含所監控之 filePath
的大小總數。 這個參數會以未初始化的狀態傳遞。 主機環境會傳回此參數。
備註
這個方法由自定義快取物件和自定義變更監視器使用,這些監視器會實作主機環境的介面,以便向主機環境 IFileChangeNotificationSystem 註冊監視的檔案路徑。 方法 StartMonitoring 是由 介面的 IFileChangeNotificationSystem 實作者呼叫,以便註冊檔案或目錄以進行變更監視。