次の方法で共有


IAppHostPropertySchema::ValidationParameter プロパティ

現在のプロパティの属性検証パラメーター情報を提供します。

構文

HRESULT get_ValidationParameter(  
   [out,  
   retval,  
   string] BSTR* pbstrValidationParameter  
);  

パラメーター

pbstrValidationParameter
検証パラメーターを含む への BSTR ポインター。

戻り値

HRESULT。 有効な値を次の表に示しますが、これ以外にもあります。

説明
S_OK 操作が成功したことを示します。

解説

属性の検証は、XML が解析されるとき、および API が構成システムで値を設定する呼び出しを行うときに実行されます。

次の表に、使用可能な検証の種類を示します。

検証タイプ 説明
applicationPoolName プロパティ値に次のいずれかの文字が含まれている場合、検証は失敗します。 &#124;<>&\"

次の例では、プロパティ値に制限された文字のいずれかが含まれている場合、検証エラーが発生します。

validationType="applicationPoolName"

validationParameter=""
integerRange 構文: <minimum>,<maximum>[,exclude]

プロパティ値が指定した範囲外の値に設定されている場合、検証は失敗します。

次の例では、 プロパティが 1 未満または 10 より大きい値に設定されている場合、検証エラーが発生します。

validationType="integerRange"

validationParameter="1,10,exclude"
nonEmptyString プロパティ値が空の文字列に設定されている場合、検証は失敗します。

次の例では、プロパティ値が空の文字列に設定されている場合、検証エラーが発生します。

validationType="nonEmptyString"

validationParameter=""
siteName プロパティ値に次のいずれかの文字が含まれている場合、検証は失敗します。 /\.?

次の例では、プロパティ値に制限された文字のいずれかが含まれている場合、検証エラーが発生します。

validationType="siteName"

validationParameter=""
timeSpanRange 構文: <minimum>,<maximum>,<granularity>[,exclude]

プロパティ値が指定した範囲外の値に設定されている場合、検証は失敗します。 <granularity>は、 と <maximum>の間<minimum>で許可される増分を示します。

次の例では、 プロパティが 1 より小さい値 (2592000 より大きい値) に設定され、範囲内で 60 の増分ではない場合、検証エラーが発生します。

validationType="timeSpanRange"

validationParameter="1,2592000,60"
requireTrimmedString プロパティ値の先頭または末尾に空白が見つかった場合、検証は失敗します。

次の例では、プロパティ値に値の先頭または末尾に空白が含まれている場合、検証エラーが発生します。

validationType="requireTrimmedString"

validationParameter=""

要件

Type 説明
Client - Windows Vista 上の IIS 7.0
- Windows 7 上の IIS 7.5
- Windows 8 の IIS 8.0
- Windows 10の IIS 10.0
サーバー - Windows Server 2008 の IIS 7.0
- Windows Server 2008 R2 上の IIS 7.5
- Windows Server 2012 上の IIS 8.0
- Windows Server 2012 R2 上の IIS 8.5
- Windows Server 2016上の IIS 10.0
製品 - IIS 7.0、IIS 7.5、IIS 8.0、IIS 8.5、IIS 10.0
- IIS Express 7.5、IIS Express 8.0、IIS Express 10.0
Header Ahadmin.h

参照

IAppHostPropertySchema インターフェイス
IAppHostPropertySchema::ValidationType プロパティ