Timer.SynchronizingObject 屬性

定義

命名空間:

System.Timers

組件:

netstandard.dll, System.ComponentModel.TypeConverter.dll

來源:

Timer.cs

取得或設定物件，用來封送處理事件處理常式的呼叫 (當間隔已經耗盡時所發出)。

public System.ComponentModel.ISynchronizeInvoke? SynchronizingObject { get; set; }

屬性值

ISynchronizeInvoke

ISynchronizeInvoke，表示用來封送處理事件處理常式呼叫 (當間隔已經耗盡時所發出) 的物件。 預設為 null。

範例

下列範例是Windows Forms應用程式，可作為非常簡單的文字檔編輯器。 當文字方塊中的文字尚未儲存時，應用程式會以一分鐘間隔詢問使用者是否要儲存文字方塊的內容。 若要這樣做， Interval 屬性會設定為 60，000 毫秒 (60，000 毫秒) ，而 SynchronizingObject 屬性會設定為 Form 物件。

using System;
using System.IO;
using  Timers = System.Timers;
using System.Windows.Forms;
public partial class Form1 : Form
{
    Timers.Timer timer = null;
    StreamWriter sw = null;
    bool hasChanged = false;
    bool dialogIsOpen = false;
    int elapsedMinutes = 0;
    // Cache the text box cache internally without saving it.
    String txt = "";

    public Form1()
    {
        InitializeComponent();

        this.Text = "Quick Text Editor";
        button1.Text = "Save";
        textBox1.Multiline = true;

        // Configure the SaveFile dialog
        saveFileDialog1.Filter = "txt files (*.txt)|*.txt|All files (*.*)|*.*";
        saveFileDialog1.RestoreDirectory = true;

        // Create a timer with a 1-minute interval
        timer = new Timers.Timer(60000);
        // Define the event handler
        timer.Elapsed += this.PromptForSave;
        // Synchronize the timer with the text box
        timer.SynchronizingObject = this;
        // Start the timer
        timer.AutoReset = true;
    }

    private void PromptForSave(Object source, Timers.ElapsedEventArgs e)
    {
        if (hasChanged & (!dialogIsOpen)) {
            elapsedMinutes++;
            dialogIsOpen = true;
            if (MessageBox.Show(String.Format("{0} minutes have elapsed since the text was saved. Save it now? ",
                elapsedMinutes), "Save Text",
                MessageBoxButtons.YesNoCancel, MessageBoxIcon.Question) == DialogResult.Yes)
            {
                button1_Click(this, EventArgs.Empty);
                dialogIsOpen = false;
            }
        }
    }

    private void button1_Click(Object sender, EventArgs e)
    {
        if (String.IsNullOrEmpty(saveFileDialog1.FileName)) {
            if (saveFileDialog1.ShowDialog() == DialogResult.OK)
                sw = new StreamWriter(saveFileDialog1.FileName, false);
        }
        txt = textBox1.Text;
        hasChanged = false;
        timer.Stop();
    }

    private void form1_FormClosing(Object sender, FormClosingEventArgs e)
    {
        if (sw != null) {
            sw.Write(txt);
            sw.Close();
        }
    }

    private void textBox1_TextChanged(Object sender, EventArgs e)
    {
        hasChanged = true;
        timer.Start();
    }
}

此範例會要求您將下列控制項新增至表單：

• TextBox名為 TextBox1 的控制項 (其預設名稱) 。

• Button名為 Button1 的控制項 (其預設名稱) 。

• SaveFileDialog名為 SaveSaveFileDialog1 的控制項 (其預設名稱) 。

備註

當 為 null 時 SynchronizingObject ，會從系統執行緒集區呼叫處理 Elapsed 事件的方法。 如需系統執行緒集區的詳細資訊，請參閱 ThreadPool 。

Elapsed當視覺效果Windows Forms元件處理事件時，例如按鈕，透過系統執行緒集區存取元件可能會導致例外狀況，或只是無法運作。 藉由將 設定 SynchronizingObject 為 Windows Forms 元件來避免這個效果，這會導致處理事件的方法 Elapsed 在元件建立所在的相同執行緒上呼叫。

注意

即使 SynchronizingObject 屬性不是 null ， Elapsed 事件也可能發生在 呼叫 或 Stop 方法之後 Dispose ，或屬性設定為 false 之後 Enabled ，因為引發 Elapsed 事件的訊號一律會排入佇列，以線上程集區執行緒上執行。 解決此競爭條件的其中一種方法是設定旗標，告知事件的事件處理常式 Elapsed 忽略後續事件。

Timer如果在Windows Forms設計工具的 Visual Studio 內使用 ， SynchronizingObject 則會自動設定為包含 的 Timer 控制項。 例如，如果您在繼承自 Form) 之 (設計工具 Form1 上放置 Timer ，則 SynchronizingObject 的 Timer 屬性會設定為 的 Form1 實例。

適用於

另請參閱

• Form
• ISynchronizeInvoke
• ThreadPool
• Elapsed