WorkbookBase.ChangeFileAccess メソッド
ブックのアクセス許可を変更します。このためには、更新されたバージョンをディスクからロードする必要がある場合があります。
名前空間: 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,
false);
}
}
}
.NET Framework セキュリティ
- 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。