Omission de valeurs pour les objets de service Web facultatifs

Les propriétés de plusieurs types complexes de services Web Report Server sont souvent suivies d'une propriété appelée Specified. Lorsque c'est le cas, le nom des propriétés se compose de leur nom original suivi de la mention « Specified ». La présence de cette mention signifie que certaines valeurs des propriétés peuvent parfois être omises. Ce phénomène est la conséquence directe de la conversion à partir du langage WSDL (Web Service Description Language) dans une classe proxy du .NET Framework. Par exemple, la propriété de service Web Enabled de type complexe DataSourceDefinition est suivie d'une propriété intitulée EnabledSpecified. Lorsque vous développez une application et que vous ne souhaitez pas définir de valeur pour la propriété Enabled, vous n'avez pas à attribuer de valeur à Enabled, la valeur par défaut true étant en effet utilisée. Toutefois, pour que cette opération se vérifie, vous devez au préalable définir EnabledSpecified sur false. Lorsque vous attribuez une valeur à la propriété Enabled, vous devez définir EnabledSpecified sur true. Seules les propriétés accessibles en écriture nécessitent de respecter cette condition. En revanche, les propriétés en lecture seule ne requièrent aucune action de votre part.

Important

Si vous ne parvenez pas à spécifier une propriété en suivant la procédure mentionnée ci-avant, le comportement du service Web peut se révéler imprévisible.

Les types de données qui nécessitent habituellement l'utilisation de la propriété supplémentaire Specified sont Boolean, DateTime et Enumeration.

Pour obtenir un exemple, consultez la méthode CreateDataSource.