Elemento Function (SSDL)

Articolo
02/27/2011

L'elemento Function in SSDL (Store Schema Definition Language) specifica una stored procedure presente nel database sottostante.

L'elemento Function può includere i seguenti elementi figlio (nell'ordine elencato):

Documentation (zero o un elemento)
CommandText (zero o un elemento)
Parameter (zero o più elementi)
Elementi Annotation (zero o più elementi)

È possibile importare stored procedure specificate nel modello di archiviazione nel modello concettuale di un'applicazione. Per ulteriori informazioni, vedere How to: Import a Stored Procedure. L'elemento Function può inoltre essere utilizzato per definire funzioni personalizzate nel modello di archiviazione. Per ulteriori informazioni, vedere How to: Define Custom Functions in the Storage Model.

Attributi applicabili

Nella tabella riportata di seguito vengono descritti gli attributi che è possibile applicare all'elemento Function.

Nota:
È possibile che alcuni attributi non presenti in questo elenco siano qualificati con l'alias store, ovvero l'alias per lo spazio dei nomi https://schemas.microsoft.com/ado/2007/12/edm/EntityStoreSchemaGenerator.Questi attributi vengono utilizzati dalla procedura guidata Aggiorna modello in caso di aggiornamento di un modello.

Nome attributo	È obbligatorio	Valore
Name	Sì	Nome della stored procedure.
ReturnType	No	Tipo restituito della stored procedure.
Aggregate	No	True se la stored procedure restituisce un valore di aggregazione; in caso contrario False.
BuiltIn	No	True se la funzione è incorporata 1; in caso contrario, False.
StoreFunctionName	No	Nome della stored procedure.
NiladicFunction	No	True se la funzione è senza parametri 2; in caso contrario, False.
IsComposable	No	True se la funzione è componibile 3; in caso contrario, False.
ParameterTypeSemantics	No	Enumerazione che definisce la semantica dei tipi utilizzata per risolvere gli overload della funzione. L'enumerazione è definita nel file manifesto del provider per ogni definizione di funzione. Il valore predefinito è AllowImplicitConversion.
Schema	No	Nome dello schema in cui viene definita la stored procedure.

1 Una funzione incorporata è una funzione definita nel database. Per informazioni sulle funzioni definite nel modello di archiviazione, vedere Elemento CommandText (SSDL).

2 Una funzione senza parametri è una funzione che non accetta parametri e, in caso di chiamata, non richiedere le parentesi.

3 Due funzioni sono componibili se l'output di una funzione può essere l'input per l'altra.

Nota:
È possibile applicare un numero qualsiasi di attributi di annotazione (attributi XML personalizzati) all'elemento Function.Tuttavia, gli attributi personalizzati non possono appartenere ad alcuno spazio dei nomi XML riservato a SSDL.I nomi completi per due attributi personalizzati qualsiasi non possono essere uguali.

Esempio

Nell'esempio riportato di seguito viene illustrato un elemento Function corrispondente alla stored procedure UpdateOrderQuantity. La stored procedure accetta due parametri e non restituisce alcun valore.

<Function Name="UpdateOrderQuantity" 
          Aggregate="false" 
          BuiltIn="false" 
          NiladicFunction="false" 
          IsComposable="false" 
          ParameterTypeSemantics="AllowImplicitConversion" 
          Schema="dbo">
  <Parameter Name="orderId" Type="int" Mode="In" />
  <Parameter Name="newQuantity" Type="int" Mode="In" />
</Function>

Condividi tramite

Elemento Function (SSDL)

Attributi applicabili

Esempio

Vedere anche

Concetti

Altre risorse

Risorse aggiuntive