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. Игнорируется, если нет пароля для файла или если Mode имеет значение xlReadOnly.

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.

Применяется к

Share via