オプションの Web サービス オブジェクトの値の省略
レポート サーバー Web サービス複合型のプロパティには、Specified プロパティと呼ばれる付随するプロパティを持つものがあります。このプロパティには、元のプロパティ名に "Specified" が付加された名前が割り当てられます。このプロパティが存在することは、元のプロパティ値が省略される可能性があることを示しています。これは、Web サービス記述言語 (WSDL) から .NET Framework のプロキシ クラスに変換した直接的な結果です。たとえば、複合型 DataSourceDefinition の Web サービス プロパティ Enabled には、EnabledSpecified という名前の付随するプロパティがあります。アプリケーションを構築していて、Enabled プロパティの値を設定したくない場合は、Enabled の値を指定する必要はありません。true という既定値が使用されます。ただし、EnabledSpecified は false に設定する必要があります。Enabled プロパティの値を指定する場合は、EnabledSpecified を true に設定する必要があります。これは書き込み可能なプロパティに適用されます。読み取り専用プロパティの場合は、アクションを行う必要がありません。
重要 |
---|
このような方法を使用したプロパティの設定に失敗すると、予想されない Web サービスの動作が発生する可能性があります。 |
通常、追加の Specified プロパティの処理を必要とするデータ型は、Boolean、DateTime、および Enumeration です。
例については、CreateDataSource メソッドを参照してください。