WorkbookBase.ChangeFileAccess-Methode

Artikel
08/10/2011

Ändert die Zugriffsberechtigungen für die Arbeitsmappe. Dazu muss unter Umständen eine aktualisierte Version vom Datenträger geladen werden.

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel.v4.0.Utilities (in Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Syntax

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

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

Parameter

mode
Typ: Microsoft.Office.Interop.Excel.XlFileAccess
Einer der XlFileAccess-Werte.Gibt den neuen Zugriffsmodus an.

writePassword
Typ: System.Object
Gibt das Kennwort für den exklusiven Schreibzugriff an, wenn für die Datei ein exklusiver Schreibzugriff besteht und Mode den Wert xlReadWrite aufweist.Wird ignoriert, wenn es kein Kennwort für die Datei gibt oder wenn Mode den Wert xlReadOnly besitzt.

notify
Typ: System.Object
true, wenn Benutzer benachrichtigt werden sollen, falls nicht sofort auf die Datei zugegriffen werden kann.

Hinweise

Wenn Sie eine Datei im schreibgeschützten Modus öffnen, haben Sie keinen exklusiven Zugriff auf die Datei. Wenn Sie Lese- und Schreibzugriff auf eine Datei haben möchten, die Sie im schreibgeschützten Modus geöffnet haben, muss Microsoft Office Excel eine neue Kopie der Datei laden, um sicherzustellen, dass an der Datei keine Änderungen vorgenommen wurden, während sie im schreibgeschützten Modus geöffnet war.

Optionale Parameter

Informationen zu optionalen Parametern finden Sie unter Optionale Parameter in Office-Lösungen.

Beispiele

Im folgenden Codebeispiel wird eine Meldung angezeigt, wenn die ReadOnlyRecommended-Eigenschaft auf true und die ReadOnly-Eigenschaft auf false festgelegt ist, und dann wird der Benutzer aufgefordert, den Dateizugriff durch Aufrufen der ChangeFileAccess-Methode auf schreibgeschützt festzulegen.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

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-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

WorkbookBase Klasse

Microsoft.Office.Tools.Excel-Namespace

Freigeben über