XML スニペット: System.DateTime 型パラメーターの既定値を指定する

最終更新日: 2010年4月15日

適用対象: SharePoint Server 2010

メソッドの中には複雑なシグネチャを持つものもあります。たとえば、SAP の顧客を取得する Web サービスに 6 つのパラメーターがあるとして、そのうちの 3 つはサブパラメーターを持つ構造体であることが考えられます。ユーザーがこれらのメソッドを簡単に呼び出せるように、Business Data Connectivity (BDC) service では、メタデータにパラメーターの既定値を指定できます。このためユーザーは、パラメーターの構築を行うことなく、事前に定義されたビジネス ロジックを呼び出すことができます。

ユーザーは、DefaultValue が定義された入力パラメータを上書きするこができます。必須の入力パラメータに DefaultValue が指定されていない場合は、ユーザーがそのパラメータを指定する必要があります。

TypeDescriptor オブジェクトの各抽象プリミティブ型に複数の既定値を定義し、それぞれの既定値を特定の MethodInstance オブジェクトに対応させることができます。実行時には、クライアントが実行する MethodInstance オブジェクトに応じて、対応する既定値を基にしてパラメーターのインスタンスが作成されます。

「DefaultValues の DefaultValue 要素 (BDCMetadata スキーマ)」に、さまざまな型について、既定値を指定する際に使用できる書式を記載します。このトピックに記載されているように、System.DateTime 型の入力パラメーターを持つ Web メソッドに既定値を指定するには、値を DateTimeFormatInfo.UniversalSortableDateTimePattern の書式で渡す必要があります。以下のコードはその例を示しています。

注意

既定値に正しくない DateTime 書式を使用すると、アプリケーション定義ファイルをインポートする際に、この「既定値を種類 System.DateTime で解析できませんでした」というエラーが発生します。書式が正しく、値を引用符で囲んでいないことを確認してください。

例

<DefaultValues>
    <DefaultValue MethodInstanceName="InvoiceFinderInstance" 
       Type="System.DateTime">2007-01-11 00:00:00Z
    </DefaultValue>
</DefaultValues>