Excel.WorksheetProtection class
ワークシート オブジェクトの保護を表します。
- Extends
注釈
プロパティ
allow |
このワークシート内の |
can |
このワークシートの保護を一時停止できるかどうかを指定します。 |
context | オブジェクトに関連付けられている要求コンテキスト。 これにより、アドインのプロセスが Office ホスト アプリケーションのプロセスに接続されます。 |
is |
シートがパスワードで保護されているかどうかを指定します。 |
is |
ワークシートの保護を一時停止するかどうかを指定します。 |
options | ワークシートの保護オプションを指定します。 |
protected | ワークシートが保護されているかどうかを指定します。 |
saved |
ワークシートに保存されている保護オプションを指定します。 これにより、ワークシートの保護状態に関係なく、同じ |
メソッド
check |
パスワードを使用してワークシート保護のロックを解除できるかどうかを指定します。 このメソッドでは、ワークシート保護の状態は変更されません。 パスワードを入力しても、ワークシート保護のロックを解除するためにパスワードが必要ない場合、このメソッドは false を返します。 |
load(options) | オブジェクトの指定されたプロパティを読み込むコマンドを待ち行列に入れます。 プロパティを読み取る前に、 |
load(property |
オブジェクトの指定されたプロパティを読み込むコマンドを待ち行列に入れます。 プロパティを読み取る前に、 |
load(property |
オブジェクトの指定されたプロパティを読み込むコマンドを待ち行列に入れます。 プロパティを読み取る前に、 |
pause |
現在のセッションのユーザーの特定のワークシート オブジェクトのワークシート保護を一時停止します。 ワークシートの保護が有効になっていないか、既に一時停止されている場合、このメソッドは何も実行しません。 パスワードが正しくない場合、このメソッドはエラーを |
protect(options, password) | ワークシートを保護します。 ワークシートが既に保護されている場合、失敗します。 |
resume |
特定のセッション内のユーザーの特定のワークシート オブジェクトのワークシート保護を再開します。 このメソッドを機能させるには、ワークシートの保護を一時停止する必要があります。 ワークシートの保護が一時停止されていない場合、このメソッドはワークシートの保護状態を変更しません。 |
set |
オブジェクトに関連付けられているパスワードを |
toJSON() | API オブジェクトが に渡されたときにより便利な出力を提供するために、JavaScript |
unprotect(password) | ワークシートの保護を解除します。 |
update |
オブジェクトに関連付けられているワークシート保護オプションを |
プロパティの詳細
allowEditRanges
このワークシート内の AllowEditRangeCollection
オブジェクトを指定します。 これは、ワークシート保護プロパティを使用するオブジェクトの AllowEditRange
コレクションです。 ワークシート保護を有効にすると、オブジェクトを AllowEditRange
使用して特定の範囲の編集を許可しながら、ワークシートの残りの部分で保護を維持できます。
readonly allowEditRanges: Excel.AllowEditRangeCollection;
プロパティ値
注釈
canPauseProtection
このワークシートの保護を一時停止できるかどうかを指定します。
readonly canPauseProtection: boolean;
プロパティ値
boolean
注釈
context
オブジェクトに関連付けられている要求コンテキスト。 これにより、アドインのプロセスが Office ホスト アプリケーションのプロセスに接続されます。
context: RequestContext;
プロパティ値
isPasswordProtected
シートがパスワードで保護されているかどうかを指定します。
readonly isPasswordProtected: boolean;
プロパティ値
boolean
注釈
isPaused
ワークシートの保護を一時停止するかどうかを指定します。
readonly isPaused: boolean;
プロパティ値
boolean
注釈
options
ワークシートの保護オプションを指定します。
readonly options: Excel.WorksheetProtectionOptions;
プロパティ値
注釈
protected
savedOptions
ワークシートに保存されている保護オプションを指定します。 これにより、ワークシートの保護状態に関係なく、同じ WorksheetProtectionOptions
オブジェクトが返されます。
readonly savedOptions: Excel.WorksheetProtectionOptions;
プロパティ値
注釈
メソッドの詳細
checkPassword(password)
パスワードを使用してワークシート保護のロックを解除できるかどうかを指定します。 このメソッドでは、ワークシート保護の状態は変更されません。 パスワードを入力しても、ワークシート保護のロックを解除するためにパスワードが必要ない場合、このメソッドは false を返します。
checkPassword(password?: string): OfficeExtension.ClientResult<boolean>;
パラメーター
- password
-
string
保護されたワークシートに対してチェックするパスワード。
戻り値
OfficeExtension.ClientResult<boolean>
パスワードを true
使用してワークシート保護のロックを解除できる場合は を返します。 それ以外の場合は を返します false
。
注釈
load(options)
オブジェクトの指定されたプロパティを読み込むコマンドを待ち行列に入れます。 プロパティを読み取る前に、context.sync()
を呼び出す必要があります。
load(options?: Excel.Interfaces.WorksheetProtectionLoadOptions): Excel.WorksheetProtection;
パラメーター
読み込むオブジェクトのプロパティのオプションを提供します。
戻り値
load(propertyNames)
オブジェクトの指定されたプロパティを読み込むコマンドを待ち行列に入れます。 プロパティを読み取る前に、context.sync()
を呼び出す必要があります。
load(propertyNames?: string | string[]): Excel.WorksheetProtection;
パラメーター
- propertyNames
-
string | string[]
読み込むプロパティを指定するコンマ区切り文字列または文字列の配列。
戻り値
load(propertyNamesAndPaths)
オブジェクトの指定されたプロパティを読み込むコマンドを待ち行列に入れます。 プロパティを読み取る前に、context.sync()
を呼び出す必要があります。
load(propertyNamesAndPaths?: {
select?: string;
expand?: string;
}): Excel.WorksheetProtection;
パラメーター
- propertyNamesAndPaths
-
{ select?: string; expand?: string; }
propertyNamesAndPaths.select
は、読み込むプロパティを指定するコンマ区切り文字列で propertyNamesAndPaths.expand
、読み込むナビゲーション プロパティを指定するコンマ区切りの文字列です。
戻り値
pauseProtection(password)
現在のセッションのユーザーの特定のワークシート オブジェクトのワークシート保護を一時停止します。 ワークシートの保護が有効になっていないか、既に一時停止されている場合、このメソッドは何も実行しません。 パスワードが正しくない場合、このメソッドはエラーを InvalidArgument
スローし、保護の一時停止に失敗します。 ワークシートの保護が有効になっていないか、既に一時停止している場合、このメソッドは保護の状態を変更しません。
pauseProtection(password?: string): void;
パラメーター
- password
-
string
保護されたワークシートに関連付けられているパスワード。
戻り値
void
注釈
protect(options, password)
ワークシートを保護します。 ワークシートが既に保護されている場合、失敗します。
protect(options?: Excel.WorksheetProtectionOptions, password?: string): void;
パラメーター
- options
- Excel.WorksheetProtectionOptions
オプション。 シートの保護のオプション。
- password
-
string
オプション。 シート保護パスワード。
戻り値
void
注釈
[ API セット: オプションの場合は ExcelApi 1.2、パスワードの場合は 1.7 ]
例
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/50-workbook/data-protection.yaml
let password = await passwordHandler();
passwordHelper(password);
await Excel.run(async (context) => {
let activeSheet = context.workbook.worksheets.getActiveWorksheet();
activeSheet.load("protection/protected");
await context.sync();
if (!activeSheet.protection.protected) {
activeSheet.protection.protect(null, password);
}
});
resumeProtection()
特定のセッション内のユーザーの特定のワークシート オブジェクトのワークシート保護を再開します。 このメソッドを機能させるには、ワークシートの保護を一時停止する必要があります。 ワークシートの保護が一時停止されていない場合、このメソッドはワークシートの保護状態を変更しません。
resumeProtection(): void;
戻り値
void
注釈
setPassword(password)
オブジェクトに関連付けられているパスワードを WorksheetProtection
変更します。 パスワードを空の文字列 ("") または as として null
設定すると、オブジェクトからパスワード保護が WorksheetProtection
削除されます。 このメソッドを正常に動作させるには、ワークシート保護を有効にして一時停止する必要があります。 ワークシート保護が無効になっている場合、このメソッドはエラーを InvalidOperation
スローし、パスワードの変更に失敗します。 ワークシート保護が有効になっていて一時停止していない場合、このメソッドはエラーを AccessDenied
スローし、パスワードの変更に失敗します。
setPassword(password?: string): void;
パラメーター
- password
-
string
オブジェクトに WorksheetProtection
関連付けられているパスワード。
戻り値
void
注釈
toJSON()
API オブジェクトが に渡されたときにより便利な出力を提供するために、JavaScript toJSON()
メソッドを JSON.stringify()
オーバーライドします。 (JSON.stringify
さらに、渡される オブジェクトの メソッドを呼び出 toJSON
します)。元の Excel.WorksheetProtection オブジェクトは API オブジェクトですが、メソッドは、元の toJSON
オブジェクトから読み込まれた子プロパティの浅いコピーを含むプレーンな JavaScript オブジェクト (として Excel.Interfaces.WorksheetProtectionData
型指定) を返します。
toJSON(): Excel.Interfaces.WorksheetProtectionData;
戻り値
unprotect(password)
ワークシートの保護を解除します。
unprotect(password?: string): void;
パラメーター
- password
-
string
シート保護パスワード。
戻り値
void
注釈
[ API セット: ExcelApi 1.7 for password ]
例
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/50-workbook/data-protection.yaml
let password = await passwordHandler();
passwordHelper(password);
await Excel.run(async (context) => {
let activeSheet = context.workbook.worksheets.getActiveWorksheet();
activeSheet.protection.unprotect(password);
});
updateOptions(options)
オブジェクトに関連付けられているワークシート保護オプションを WorksheetProtection
変更します。 このメソッドを正常に動作させるには、ワークシート保護を無効または一時停止する必要があります。 ワークシート保護が有効になっていて一時停止していない場合、このメソッドはエラーを AccessDenied
スローし、ワークシート保護オプションの変更に失敗します。
updateOptions(options: Excel.WorksheetProtectionOptions): void;
パラメーター
- options
- Excel.WorksheetProtectionOptions
オブジェクトに関連付 WorksheetProtection
けられているオプション インターフェイス。
戻り値
void
注釈
Office Add-ins
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示