ObjectContext.ExecuteFunction Méthode

  • Référence

Définition

Espace de noms:
System.Data.Objects
Assembly:
System.Data.Entity.dll

Surcharges

ExecuteFunction(String, ObjectParameter[])

Exécute une fonction ou procédure stockée qui est 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 et retourne le nombre de lignes affectées par l'exécution.
ExecuteFunction<TElement>(String, ObjectParameter[])

Exécute une fonction ou procédure stockée qui est 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 ObjectResult<T> typé.
ExecuteFunction<TElement>(String, MergeOption, ObjectParameter[])

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

ExecuteFunction(String, ObjectParameter[])

Exécute une fonction ou procédure stockée qui est 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 et 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 fonction ou procédure stockée. Le nom peut inclure le nom du conteneur, par exemple <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

function a la valeur null ou est vide

- ou -

function est introuvable.

InvalidOperationException

Le lecteur d'entités ne prend pas en charge ce function.

- ou -

Il existe une incompatibilité de type entre le lecteur et la function.

S’applique à

ExecuteFunction<TElement>(String, ObjectParameter[])

Exécute une fonction ou procédure stockée qui est 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 ObjectResult<T> typé.

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> retourné lorsque la fonction est exécutée sur la source de données. Ce type doit implémenter IEntityWithChangeTracker.

Paramètres

functionName
String

Nom de la fonction ou procédure stockée. Le nom peut inclure le nom du conteneur, par exemple <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

ObjectResult<TElement>

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

Exceptions

ArgumentException

function a la valeur null ou est vide

- ou -

function est introuvable.

InvalidOperationException

Le lecteur d'entités ne prend pas en charge ce function.

- ou -

Il existe une incompatibilité de type entre le lecteur et la function.

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 fortement typé ExecuteFunction pour retourner un typé ObjectResult<T>. Pour plus d’informations, consultez Code d’application à l’aide de procédures stockées (Entity Framework).

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 n’est pas chargé à partir de la source de données.

Voir aussi

S’applique à

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

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

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> retourné lorsque la fonction est exécutée sur la source de données. Ce type doit implémenter IEntityWithChangeTracker.

Paramètres

functionName
String

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

mergeOption
MergeOption

Objet MergeOption à utiliser lors de l'exécution de la requête.

parameters
ObjectParameter[]

Tableau d'objets ObjectParameter.

Retours

ObjectResult<TElement>

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

Exceptions

ArgumentException

function a la valeur null ou est vide

- ou -

function est introuvable.

InvalidOperationException

Le lecteur d'entités ne prend pas en charge ce function.

- ou -

Il existe une incompatibilité de type entre le lecteur et la function.

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 fortement typé ExecuteFunction pour retourner un typé ObjectResult<T>. Pour plus d’informations, consultez Code d’application à l’aide de procédures stockées (Entity Framework).

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.

Voir aussi

S’applique à