WorkbookBase.ChangeFileAccess(XlFileAccess, Object, Object) Metoda

Definicja

Przestrzeń nazw:

Microsoft.Office.Tools.Excel

Zestaw:

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

Zmienia uprawnienia dostępu do skoroszytu. Może to wymagać załadowania zaktualizowanej wersji z dysku.

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)

Parametry

mode

XlFileAccess

XlFileAccess Jedna z wartości. Określa nowy tryb dostępu.

writePassword

Object

Określa hasło zarezerwowane zapisu, jeśli plik jest zastrzeżony i Mode ma wartość xlReadWrite. Ignorowane, jeśli nie ma hasła do pliku lub jeśli Mode ma wartość xlReadOnly.

notify

Object

true aby powiadomić użytkownika, jeśli nie można natychmiast uzyskać dostępu do pliku.

Przykłady

Poniższy przykład kodu wyświetla komunikat, jeśli ReadOnlyRecommended właściwość to true , a ReadOnly właściwość to false, a następnie monituje użytkownika o ustawienie dostępu do pliku tylko do odczytu przez wywołanie ChangeFileAccess metody .

Ten przykład dotyczy dostosowywania na poziomie dokumentu.

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

Uwagi

Jeśli plik jest otwarty w trybie tylko do odczytu, nie masz wyłącznego dostępu do pliku. Jeśli zmienisz plik z tylko do odczytu na odczyt/zapis, program Microsoft Office Excel musi załadować nową kopię pliku, aby upewnić się, że podczas otwierania pliku jako tylko do odczytu nie wprowadzono żadnych zmian.

Parametry opcjonalne

Aby uzyskać informacje na temat parametrów opcjonalnych, zobacz Parametry opcjonalne w rozwiązaniach pakietu Office.