WorkbookBase.ChangeFileAccess - метод

Статья
08/11/2011

Изменяет права доступа для книги. Может потребоваться загрузка обновленной версии с диска.

Пространство имен: 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,
                missing, false);
        }
    }
}

Безопасность платформы .NET Framework

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.

См. также

Ссылки

WorkbookBase Класс

Microsoft.Office.Tools.Excel - пространство имен

Поделиться через