ErrorImage

錯誤回應影像。發生錯誤時，「影像伺服」通常會傳回錯誤狀態並顯示文字訊息。

attribute::ErrorImage 允許設定發生錯誤時要傳回的影像、目錄專案或範本。

注意

遺失的影像也可以透過處理 attribute::DefaultImage.

您可以設定「影像伺服」範本，將錯誤訊息文字轉譯為回應影像。下列預先定義的變數可包含在 $error.title 範本，以簡短錯誤說明取代，以及 $error.message，以更詳細的錯誤說明取代(詳細資訊層級設定為 attribute::ErrorDetail)。

如果可以成功處理錯誤影像/範本，則會傳回HTTP狀態200。如果在此處理期間發生錯誤，則會傳回HTTP錯誤狀態和文字訊息。

屬性

文字字串。如果已指定，則必須是影像目錄中的有效目錄：：Id值或相對(至 attribute::RootPath)或影像伺服器可存取之影像檔案的絕對路徑。

繼承自 default::ErrorImage 若未定義。如果已定義但為空，則會停用錯誤影像行為，即使 default::ErrorImage 已定義，且會傳回HTTP錯誤狀態和文字訊息。

若要取得回應影像，並將錯誤訊息演算至影像中，我們首先必須在影像目錄中定義範本。在此情況下，我們在影像目錄中建立一個名為的專案 onError，包含下列專案 catalog::Modifier：

size=300,300&bgc=ffffff&text=$error.message$

範本註冊於 attribute::ErrorImage：

ErrorImage=myCatalog/onError

在此範例中，文字會使用預設字型、字型顏色和字型大小呈現。