WorkbookBase.ChangeFileAccess 方法

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

命名空間：  Microsoft.Office.Tools.Excel
組件：  Microsoft.Office.Tools.Excel.v4.0.Utilities (在 Microsoft.Office.Tools.Excel.v4.0.Utilities.dll 中)

語法

'宣告
Public Sub ChangeFileAccess ( _
    mode As XlFileAccess, _
    writePassword As Object, _
    notify As Object _
)

public void ChangeFileAccess(
    XlFileAccess mode,
    Object writePassword,
    Object notify
)

參數

• mode
  型別：Microsoft.Office.Interop.Excel.XlFileAccess
  其中一個 XlFileAccess 值。指定新的存取模式。

• writePassword
  型別：System.Object
  如果檔案需要修改權且 Mode 為 xlReadWrite，則指定修改權密碼。如果檔案沒有密碼，或如果 Mode 為 xlReadOnly 則予以忽略。

• notify
  型別：System.Object
  true 表示通知使用者檔案無法立即存取。

備註

如果您以唯讀模式開啟檔案，則不能單獨存取該檔。如果您將檔案從唯讀變更成可讀/寫，Microsoft Office Excel 必須載入檔案的新複本，確保以唯讀方式開啟檔案時不會做出任何變更。

選擇性參數

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

範例

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

這是示範文件層級自訂的範例。

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

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);
        }
    }
}

.NET Framework 安全性

• 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊，請參閱從部分受信任程式碼使用程式庫。

請參閱

參考

WorkbookBase 類別

Microsoft.Office.Tools.Excel 命名空間