XML-Codeausschnitt: Angeben eines Standardwerts für einen Parameter vom Typ "System.DateTime"

Letzte Änderung: Donnerstag, 15. April 2010

Gilt für: SharePoint Server 2010

Manche Methoden weisen komplexe Signaturen auf. Beispielsweise kann der Webdienst zum Abrufen von SAP-Kunden sechs Parameter akzeptieren, von denen drei Strukturen mit Unterparametern sein können. Der Business Data Connectivity-Dienst (BDC) ermöglicht das Angeben von Standardwerten für Parameter in den Metadaten, um Benutzern das Aufrufen dieser Methoden zu vereinfachen. Dadurch können Benutzer vordefinierte Geschäftslogik aufrufen, ohne Parameter erstellen zu müssen.

Der Benutzer kann Eingabeparameter überschreiben, für die Sie einen DefaultValue definieren. Der Benutzer muss alle Eingabeparameter angeben, für die es keinen DefaultValue gibt, falls der Parameter nicht optional ist.

Für jeden abstrakten primitiven Typ in einem TypeDescriptor-Objekt können Sie mehrere Standardwerte definieren, die jeweils einem bestimmten MethodInstance-Objekt entsprechen. Zur Laufzeit wird in Abhängigkeit vom MethodInstance-Objekt, das der Client ausführt, eine Instanz des Parameters basierend auf den entsprechenden Standardwerten erstellt.

Im Thema "DefaultValue"-Element in "DefaultValues" (BDCMetadata-Schema) werden die zulässigen Formate zum Angeben von Standardwerten für verschiedene Typen aufgelistet. Wie in diesem Thema erwähnt, müssen Sie zum Angeben von Standardwerten für Webmethoden, die Eingabeparameter vom Typ System.DateTime aufweisen, den Wert im Format DateTimeFormatInfo.UniversalSortableDateTimePattern übergeben. Ein Beispiel hierfür finden Sie im folgenden Code.

Hinweis
Falls Sie für den Standardwert ein falsches DateTime-Format verwenden, erhalten Sie beim Importieren der Anwendungsdefinitionsdatei eine Fehlermeldung, dass der Standardwert im Typ "System.DateTime" nicht analysiert werden konnte und dass Sie sicherstellen sollten, dass das Format stimmt und der Wert nicht in Anführungszeichen eingeschlossen ist.

Beispiel

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