WorkbookBase.ChangeFileAccess(XlFileAccess, Object, Object) 方法

定義

命名空間:

Microsoft.Office.Tools.Excel

組件:

Microsoft.Office.Tools.Excel.v4.0.Utilities.dll

變更活頁簿的存取權限。 這可能需要從磁碟載入更新版本。

public void ChangeFileAccess(Microsoft.Office.Interop.Excel.XlFileAccess mode, object writePassword, object notify);

member this.ChangeFileAccess : Microsoft.Office.Interop.Excel.XlFileAccess * obj * obj -> unit

Public Sub ChangeFileAccess (mode As XlFileAccess, Optional writePassword As Object, Optional notify As Object)

參數

mode

XlFileAccess

其中一個 XlFileAccess 值。 指定新的存取模式。

writePassword

Object

如果檔案是保留的，且 Mode 為 xlReadWrite，則指定寫入保留的密碼。 如果檔案沒有密碼，或 為 ModexlReadOnly，則會忽略 。

notify

Object

true 表示通知使用者檔案無法立即存取。

範例

下列程式代碼範例會在 ReadOnlyRecommended 屬性為 true 且 ReadOnly 屬性為 false時顯示訊息，然後提示使用者呼叫 ChangeFileAccess 方法，將檔案存取設定為唯讀。

此範例適用於檔層級自定義。

private void MakeWorkbookReadOnly()
{
    if (this.ReadOnlyRecommended && !this.ReadOnly)
    {
        // Change the access level of the document to read-only if the user 
        // clicks yes.
        if (MessageBox.Show("Set this document to read-only?",
            "Sample", MessageBoxButtons.YesNo) == DialogResult.Yes)
        {
            this.ChangeFileAccess(Excel.XlFileAccess.xlReadOnly,
                 false);
        }
    }
}

Private Sub MakeWorkbookReadOnly()
    If Me.ReadOnlyRecommended AndAlso Not Me.ReadOnly Then
        ' Change the access level of the document to read-only  
        ' if the user clicks yes.
        If MessageBox.Show("Set this document to read-only?", _
            "Sample", MessageBoxButtons.YesNo) = DialogResult.Yes Then
            Me.ChangeFileAccess(Excel.XlFileAccess.xlReadOnly, Notify:=False)
        End If
    End If
End Sub

備註

如果您有以唯讀模式開啟的檔案，則沒有檔案的獨佔存取權。 如果您將檔案從只讀變更為可擦寫的，Microsoft Office Excel 必須載入新的檔案複本，以確保當您將檔案開啟為只讀時，不會進行任何變更。

選擇性參數

如需選擇性參數的資訊，請參閱 Office 方案中的選擇性參數。