Compartilhar via


Propriedade IAppHostPropertySchema::ValidationType

Descreve o tipo de validação que será executado para a propriedade atual.

Sintaxe

HRESULT get_ValidationType(  
   [out,  
   retval,  
   string] BSTR* pbstrValidationType  
);  

Parâmetros

pbstrValidationType
Um ponteiro para um BSTR que indica o tipo de validação. Os valores válidos são "applicationPath", "applicationPoolName", "integerRange", "nonEmptyString", "siteName", "timeSpanRange", "requireTrimmedString" e "virtualDirectoryPath".

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. Um <granularity> valor de 60 indica que o intervalo de tempo representa segundos e um valor de 1 indica que o intervalo de tempo representa minutos.

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

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

Tipo 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::ValidationParameter