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 値のいずれか 1 つ。 新しいアクセス モードを指定します。

writePassword

Object

ファイルが書き込み予約済みで、 が の場合は、書き込み予約パスワードをModexlReadWrite指定します。 ファイルのパスワードがない場合、または が の場合 Mode は xlReadOnly無視されます。

notify

Object

ファイルにすぐアクセスできない場合にユーザーに通知するには true に設定します。

例

次のコード例では、 プロパティが で、 プロパティが true である場合ReadOnlyRecommendedにfalseメッセージをReadOnly表示し、 メソッドを呼び出してファイル アクセスを読み取り専用に設定するようにユーザーに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

注釈

ファイルを読み取り専用モードで開いている場合、そのファイルに対する排他アクセス権はありません。 ファイルを読み取り専用から読み取り/書き込みに変更した場合、ファイルを読み取り専用として開いている間に変更が行われないように、ファイルの新しいコピーを読み込む必要があります。

省略可能のパラメーター

省略可能なパラメーターの詳細については、「 Office ソリューションの省略可能なパラメーター」を参照してください。