ObjectContext.ExecuteFunction Metodo

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.

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.

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

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>

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

• Utilizzo di oggetti (Entity Framework)

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

• Utilizzo di oggetti (Entity Framework)