ObjectContext.ExecuteFunction Méthode

Définition

Espace de noms:: System.Data.Objects

Assembly:: System.Data.Entity.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Surcharges

Nom	Description
ExecuteFunction(String, ObjectParameter[])	Exécute une procédure stockée ou une fonction définie dans la source de données et exprimée dans le modèle conceptuel ; ignore les résultats retournés par la fonction ; retourne le nombre de lignes affectées par l’exécution.
ExecuteFunction<TElement>(String, ObjectParameter[])	Exécute une procédure stockée ou une fonction définie dans la source de données et mappée dans le modèle conceptuel, avec les paramètres spécifiés. Retourne un type ObjectResult<T>.
ExecuteFunction<TElement>(String, MergeOption, ObjectParameter[])	Exécute la procédure stockée ou la fonction donnée définie dans la source de données et exprimée dans le modèle conceptuel, avec les paramètres spécifiés et l’option de fusion. Retourne un type ObjectResult<T>.

ExecuteFunction(String, ObjectParameter[])

Exécute une procédure stockée ou une fonction définie dans la source de données et exprimée dans le modèle conceptuel ; ignore les résultats retournés par la fonction ; retourne le nombre de lignes affectées par l’exécution.

public:
 int ExecuteFunction(System::String ^ functionName, ... cli::array <System::Data::Objects::ObjectParameter ^> ^ parameters);

public int ExecuteFunction(string functionName, params System.Data.Objects.ObjectParameter[] parameters);

member this.ExecuteFunction : string * System.Data.Objects.ObjectParameter[] -> int

Public Function ExecuteFunction (functionName As String, ParamArray parameters As ObjectParameter()) As Integer

Paramètres

functionName: String

Nom de la procédure stockée ou de la fonction. Le nom peut inclure le nom du conteneur, tel que <Container Name>.<Function Name>. Lorsque le nom du conteneur par défaut est connu, seul le nom de la fonction est requis.

parameters: ObjectParameter[]

Tableau d'objets ObjectParameter.

Retours

Int32

Nombre de lignes affectées.

Exceptions

ArgumentException

functionName est null ou vide.

- ou -

functionName n’est pas trouvé.

InvalidOperationException

Le lecteur d’entité ne prend pas en charge ce functionName.

- ou -

Il existe une incompatibilité de type sur le lecteur et la fonction.

S’applique à

ExecuteFunction<TElement>(String, ObjectParameter[])

Exécute une procédure stockée ou une fonction définie dans la source de données et mappée dans le modèle conceptuel, avec les paramètres spécifiés. Retourne un type ObjectResult<T>.

protected:
generic <typename TElement>
 where TElement : System::Data::Objects::DataClasses::IEntityWithChangeTracker System::Data::Objects::ObjectResult<TElement> ^ ExecuteFunction(System::String ^ functionName, ... cli::array <System::Data::Objects::ObjectParameter ^> ^ parameters);

public:
generic <typename TElement>
 System::Data::Objects::ObjectResult<TElement> ^ ExecuteFunction(System::String ^ functionName, ... cli::array <System::Data::Objects::ObjectParameter ^> ^ parameters);

protected System.Data.Objects.ObjectResult<TElement> ExecuteFunction<TElement>(string functionName, params System.Data.Objects.ObjectParameter[] parameters) where TElement : System.Data.Objects.DataClasses.IEntityWithChangeTracker;

public System.Data.Objects.ObjectResult<TElement> ExecuteFunction<TElement>(string functionName, params System.Data.Objects.ObjectParameter[] parameters);

member this.ExecuteFunction : string * System.Data.Objects.ObjectParameter[] -> System.Data.Objects.ObjectResult<'Element (requires 'Element :> System.Data.Objects.DataClasses.IEntityWithChangeTracker)> (requires 'Element :> System.Data.Objects.DataClasses.IEntityWithChangeTracker)

member this.ExecuteFunction : string * System.Data.Objects.ObjectParameter[] -> System.Data.Objects.ObjectResult<'Element>

Protected Function ExecuteFunction(Of TElement As IEntityWithChangeTracker) (functionName As String, ParamArray parameters As ObjectParameter()) As ObjectResult(Of TElement)

Public Function ExecuteFunction(Of TElement) (functionName As String, ParamArray parameters As ObjectParameter()) As ObjectResult(Of TElement)

Paramètres de type

TElement

Type d’entité du ObjectResult<T> retour lorsque la fonction est exécutée sur la source de données. Ce type doit implémenter IEntityWithChangeTracker.

Paramètres

functionName: String

parameters: ObjectParameter[]

Tableau d'objets ObjectParameter.

Retours

ObjectResult<TElement>

Pour ObjectResult<T> les données retournées par la procédure stockée.

Exceptions

ArgumentException

functionName est null ou vide

- ou -

functionName n’est pas trouvé.

InvalidOperationException

Le lecteur d’entité ne prend pas en charge cette fonction.

- ou -

Il existe une incompatibilité de type sur le lecteur et la fonction.

Remarques

La ExecuteFunction méthode est une méthode d’assistance utilisée pour exécuter des procédures stockées ou des fonctions définies dans la source de données et exprimées dans le modèle conceptuel. Les outils Entity Data Model génèrent une méthode pour chaque élément FunctionImport dans le modèle conceptuel. Ces méthodes appellent un type fort ExecuteFunction pour retourner un typé ObjectResult<T>.

Tous les paramètres de la fonction sont requis dans le tableau de paramètres et tous les types sont vérifiés par rapport aux métadonnées de la fonction d’importation, y compris le type de la fonction elle-même. null les valeurs sont autorisées pour les types de valeurs CLR. La validation des paramètres est effectuée par le fournisseur.

La ExecuteFunction méthode utilise la MergeOption valeur de AppendOnly. Par conséquent, si un objet existe déjà dans le contexte de l’objet, il ne sera pas chargé à partir de la source de données.

Voir aussi

Utilisation d’objets (Entity Framework)

S’applique à

ExecuteFunction<TElement>(String, MergeOption, ObjectParameter[])

Exécute la procédure stockée ou la fonction donnée définie dans la source de données et exprimée dans le modèle conceptuel, avec les paramètres spécifiés et l’option de fusion. Retourne un type ObjectResult<T>.

public:
generic <typename TElement>
 System::Data::Objects::ObjectResult<TElement> ^ ExecuteFunction(System::String ^ functionName, System::Data::Objects::MergeOption mergeOption, ... cli::array <System::Data::Objects::ObjectParameter ^> ^ parameters);

public System.Data.Objects.ObjectResult<TElement> ExecuteFunction<TElement>(string functionName, System.Data.Objects.MergeOption mergeOption, params System.Data.Objects.ObjectParameter[] parameters);

member this.ExecuteFunction : string * System.Data.Objects.MergeOption * System.Data.Objects.ObjectParameter[] -> System.Data.Objects.ObjectResult<'Element>

Public Function ExecuteFunction(Of TElement) (functionName As String, mergeOption As MergeOption, ParamArray parameters As ObjectParameter()) As ObjectResult(Of TElement)

Paramètres de type

TElement

Type d’entité du ObjectResult<T> retour lorsque la fonction est exécutée sur la source de données. Ce type doit implémenter IEntityWithChangeTracker.

Paramètres

functionName: String

mergeOption: MergeOption

À MergeOption utiliser lors de l’exécution de la requête.

parameters: ObjectParameter[]

Tableau d'objets ObjectParameter.

Retours

ObjectResult<TElement>

Pour ObjectResult<T> les données retournées par la procédure stockée.

Exceptions

ArgumentException

functionName est null ou vide

- ou -

functionName n’est pas trouvé.

InvalidOperationException

Le lecteur d’entité ne prend pas en charge cette fonction.

- ou -

Il existe une incompatibilité de type sur le lecteur et la fonction.

Remarques

Voir aussi

Utilisation d’objets (Entity Framework)

S’applique à

Commentaires

Cette page a-t-elle été utile ?