Compartilhar via


Propriedade IAppHostPropertySchema::ValidationParameter

Fornece informações de parâmetro de validação de atributo para a propriedade atual.

Sintaxe

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

Parâmetros

pbstrValidationParameter
Um ponteiro para um BSTR que contém o parâmetro de validação.

Valor Retornado

Um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Valor Descrição
S_OK Indica que a operação foi bem-sucedida.

Comentários

A validação de atributo é executada quando XML é analisado e quando a API faz uma chamada para definir um valor no sistema de configuração.

A tabela a seguir fornece os tipos de validação disponíveis.

Tipo de validação Descrição
applicationPoolName Falhará na validação se o valor da propriedade contiver um dos seguintes caracteres: &#124;<>&\"

O exemplo a seguir causará uma falha de validação se o valor da propriedade incluir um dos caracteres restritos.

validationType="applicationPoolName"

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

Falhará na validação se o valor da propriedade for definido como um valor fora do intervalo especificado.

O exemplo a seguir causará uma falha de validação se a propriedade for definida como um valor menor que 1 ou maior que 10.

validationType="integerRange"

validationParameter="1,10,exclude"
nonEmptyString Falhará na validação se o valor da propriedade for definido como uma cadeia de caracteres vazia.

O exemplo a seguir causará uma falha de validação se o valor da propriedade estiver definido como uma cadeia de caracteres vazia.

validationType="nonEmptyString"

validationParameter=""
siteName Falhará na validação se o valor da propriedade contiver um dos seguintes caracteres: /\.?

O exemplo a seguir causará uma falha de validação se o valor da propriedade incluir um dos caracteres restritos.

validationType="siteName"

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

Falhará na validação se o valor da propriedade for definido como um valor fora do intervalo especificado. <granularity> indica os incrementos permitidos entre <minimum> e <maximum>.

O exemplo a seguir causará uma falha de validação se a propriedade for definida como um valor menor que 1, maior que 2592000 e não for um incremento de 60 dentro do intervalo.

validationType="timeSpanRange"

validationParameter="1,2592000,60"
requireTrimmedString Falhará na validação se o espaço em branco for encontrado no início ou no final do valor da propriedade.

O exemplo a seguir causará uma falha de validação se o valor da propriedade contiver espaço em branco no início ou no final do valor.

validationType="requireTrimmedString"

validationParameter=""

Requisitos

Type Descrição
Cliente - IIS 7.0 no Windows Vista
- IIS 7.5 no Windows 7
- IIS 8.0 no Windows 8
- IIS 10.0 no Windows 10
Servidor - IIS 7.0 no Windows Server 2008
- IIS 7.5 no Windows Server 2008 R2
- IIS 8.0 no Windows Server 2012
- IIS 8.5 no Windows Server 2012 R2
- IIS 10.0 no Windows Server 2016
Produto - 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
parâmetro Ahadmin.h

Consulte Também

IAppHostPropertySchema Interface
Propriedade IAppHostPropertySchema::ValidationType