IDeliveryExtension.ValidateUserData(Setting[]) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Wird verwendet, um zu bestimmen, ob eine bestimmte Reihe von Liefererweiterungseinstellungen gültig ist.
public:
cli::array <Microsoft::ReportingServices::Interfaces::Setting ^> ^ ValidateUserData(cli::array <Microsoft::ReportingServices::Interfaces::Setting ^> ^ settings);
public Microsoft.ReportingServices.Interfaces.Setting[] ValidateUserData(Microsoft.ReportingServices.Interfaces.Setting[] settings);
abstract member ValidateUserData : Microsoft.ReportingServices.Interfaces.Setting[] -> Microsoft.ReportingServices.Interfaces.Setting[]
Public Function ValidateUserData (settings As Setting()) As Setting()
Parameter
- settings
- Setting[]
Ein Array von Setting Objekten mit Erweiterungseinstellungen, die von einem Client bereitgestellt werden.
Gibt zurück
Ein Array von Setting Objekten, die Erweiterungseinstellungen enthalten, die von der Liefererweiterung validiert wurden.
Hinweise
Die Methode ValidateUserData wird aufgerufen, wann immer ein Abonnement erstellt oder geändert wird. Sie sollten der Methode ValidateUserData Code hinzufügen, um sicherzustellen, dass die Werte, die ein Nutzer für die Einstellungen einer Liefererweiterung gewählt hat, den Anforderungen für die Auslieferung entsprechen. Zum Beispiel sollten Sie bei der E-Mail-Zustellung sicherstellen, dass die vom Nutzer angegebene E-Mail-Adresse den E-Mail-Formatierungsstandards entspricht. Bei der Druckerlieferung möchtest du vielleicht den von einem Nutzer gewählten Drucker mit der bekannten Liste der installierten Drucker auf dem Server überprüfen.
Wenn eine bestimmte Einstellung, die du validierst, eine Fehlerbedingung enthält, solltest du die Error Eigenschaft der Einstellung setzen, die nicht gültig ist. Außerdem können Sie Standardwerte für fehlende Einstellungen hinzufügen, um ein Fehlschlagen der Lieferung zu verhindern.