Compartilhar via


Omitindo valores para objetos de serviço Web opcionais

Propriedades de vários tipos complexos de serviço Web Servidor de Relatórios têm uma propriedade complementar conhecida como propriedade Specified. O nome da propriedade consiste no nome de propriedade original com a palavra "Especificada" anexada a ele. A presença dessa propriedade indica que um valor da propriedade original às vezes pode ser omitido. Este é um resultado direto da conversão da WSDL (Web Service Description Language) em uma classe proxy do .NET Framework. Por exemplo, a propriedade de serviço Web Enabled do tipo complexo DataSourceDefinition tem uma propriedade associada nomeada EnabledSpecified. Se você estiver criando um aplicativo e não desejar definir um valor para a propriedade Enabled, não precisará fornecer um valor para Enabled; o valor padrão true será usado. Porém, você ainda precisa definir EnabledSpecified como false. Se você fornecer um valor para a propriedade Enabled, precisará definir EnabledSpecified igual a true. Esse é o caso de propriedades graváveis. Para propriedades somente leitura, você não precisa tomar uma ação.

Importante

A falha em especificar uma propriedade usando a técnica supracitada pode resultar em comportamento de serviço Web imprevisível.

Os tipos de dados que costumam exigir o tratamento da propriedade Specified adicional são Boolean, DateTime e Enumeration.

Para obter um exemplo, consulte o método CreateDataSource.