ObjectContext.ExecuteFunction Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Data.Objects
Assembly:
System.Data.Entity.dll

Overload

ExecuteFunction(String, ObjectParameter[])

Esegue una stored procedure o una funzione definita nell'origine dati ed espressa nel modello concettuale, rimuove qualsiasi risultato restituito dalla funzione e restituisce il numero di righe interessate dall'esecuzione.
ExecuteFunction<TElement>(String, ObjectParameter[])

Esegue una stored procedure o una funzione definita nell'origine dati e mappata nel modello concettuale, con i parametri specificati. Restituisce un oggetto ObjectResult<T> tipizzato.
ExecuteFunction<TElement>(String, MergeOption, ObjectParameter[])

Esegue la stored procedure o la funzione specificata, definita nell'origine dati ed espressa nel modello concettuale, con i parametri specificati e l'opzione di unione. Restituisce un oggetto ObjectResult<T> tipizzato.

ExecuteFunction(String, ObjectParameter[])

Esegue una stored procedure o una funzione definita nell'origine dati ed espressa nel modello concettuale, rimuove qualsiasi risultato restituito dalla funzione e restituisce il numero di righe interessate dall'esecuzione.

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

Parametri

functionName
String

Nome della stored procedure o della funzione. Il nome può includere il nome del contenitore, ad esempio <Container Name>.<Function Name>. Quando è noto il nome del contenitore predefinito, è necessario solo il nome della funzione.

parameters
ObjectParameter[]

Matrice di oggetti ObjectParameter.

Restituisce

Int32

Numero di righe interessate.

Eccezioni

ArgumentException

function è null o vuoto.

-oppure-

function non trovata.

InvalidOperationException

Il lettore dell'entità non supporta function.

-oppure-

Tipi non corrispondenti nel lettore e in function.

Si applica a

ExecuteFunction<TElement>(String, ObjectParameter[])

Esegue una stored procedure o una funzione definita nell'origine dati e mappata nel modello concettuale, con i parametri specificati. Restituisce un oggetto ObjectResult<T> tipizzato.

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)

Parametri di tipo

TElement

Tipo di entità dell'oggetto ObjectResult<T> restituito quando viene eseguita la funzione sull'origine dati. Questo tipo deve implementare IEntityWithChangeTracker.

Parametri

functionName
String

Nome della stored procedure o della funzione. Il nome può includere il nome del contenitore, ad esempio <Container Name>.<Function Name>. Quando è noto il nome del contenitore predefinito, è necessario solo il nome della funzione.

parameters
ObjectParameter[]

Matrice di oggetti ObjectParameter.

Restituisce

ObjectResult<TElement>

Oggetto ObjectResult<T> per i dati restituiti dalla stored procedure.

Eccezioni

ArgumentException

function è null o vuoto.

-oppure-

function non trovata.

InvalidOperationException

Il lettore dell'entità non supporta function.

-oppure-

Tipi non corrispondenti nel lettore e in function.

Commenti

Il ExecuteFunction metodo è un metodo helper usato per eseguire stored procedure o funzioni definite nell'origine dati ed espresse nel modello concettuale. Gli strumenti Entity Data Model generano un metodo per ogni elemento FunctionImport nel modello concettuale. Questi metodi chiamano un oggetto fortemente tipizzato ExecuteFunction per restituire un oggetto tipizzato ObjectResult<T>. Per altre informazioni, vedere Codice dell'applicazione tramite stored procedure (Entity Framework).

Tutti i parametri per la funzione sono obbligatori nella matrice di parametri e tutti i tipi vengono controllati in base ai metadati per la funzione di importazione, incluso il tipo della funzione stessa. null i valori sono consentiti per i tipi di valore CLR. La convalida dei parametri viene eseguita dal provider.

Il ExecuteFunction metodo usa il MergeOption valore di AppendOnly. Pertanto, se un oggetto esiste già nel contesto dell'oggetto, non verrà caricato dall'origine dati.

Vedi anche

Si applica a

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

Esegue la stored procedure o la funzione specificata, definita nell'origine dati ed espressa nel modello concettuale, con i parametri specificati e l'opzione di unione. Restituisce un oggetto ObjectResult<T> tipizzato.

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)

Parametri di tipo

TElement

Tipo di entità dell'oggetto ObjectResult<T> restituito quando viene eseguita la funzione sull'origine dati. Questo tipo deve implementare IEntityWithChangeTracker.

Parametri

functionName
String

Nome della stored procedure o della funzione. Il nome può includere il nome del contenitore, ad esempio <Container Name>.<Function Name>. Quando è noto il nome del contenitore predefinito, è necessario solo il nome della funzione.

mergeOption
MergeOption

Oggetto MergeOption da utilizzare quando viene eseguita la query.

parameters
ObjectParameter[]

Matrice di oggetti ObjectParameter.

Restituisce

ObjectResult<TElement>

Oggetto ObjectResult<T> per i dati restituiti dalla stored procedure.

Eccezioni

ArgumentException

function è null o vuoto.

-oppure-

function non trovata.

InvalidOperationException

Il lettore dell'entità non supporta function.

-oppure-

Tipi non corrispondenti nel lettore e in function.

Commenti

Il ExecuteFunction metodo è un metodo helper usato per eseguire stored procedure o funzioni definite nell'origine dati ed espresse nel modello concettuale. Gli strumenti Entity Data Model generano un metodo per ogni elemento FunctionImport nel modello concettuale. Questi metodi chiamano un oggetto fortemente tipizzato ExecuteFunction per restituire un oggetto tipizzato ObjectResult<T>. Per altre informazioni, vedere Codice dell'applicazione tramite stored procedure (Entity Framework).

Tutti i parametri per la funzione sono obbligatori nella matrice di parametri e tutti i tipi vengono controllati in base ai metadati per la funzione di importazione, incluso il tipo della funzione stessa. null i valori sono consentiti per i tipi di valore CLR. La convalida dei parametri viene eseguita dal provider.

Vedi anche

Si applica a