Classe SafeToPrepareAttribute

Contrassegna i metodi nell'assembly che sono sicuri per l'esecuzione con la proprietà ExecuteForPrepare impostata su true.

Gerarchia di ereditarietà

Object
  Attribute
    Microsoft.AnalysisServices.AdomdServer.SafeToPrepareAttribute

Spazio dei nomi  Microsoft.AnalysisServices.AdomdServer
Assembly:  msmgdsrv (in msmgdsrv.dll)

Sintassi

'Dichiarazione
Public NotInheritable Class SafeToPrepareAttribute _
    Inherits Attribute
'Utilizzo
Dim instance As SafeToPrepareAttribute

public sealed class SafeToPrepareAttribute : Attribute

public ref class SafeToPrepareAttribute sealed : public Attribute

[<SealedAttribute>]
type SafeToPrepareAttribute =  
    class 
        inherit Attribute 
    end

public final class SafeToPrepareAttribute extends Attribute

Nel tipo SafeToPrepareAttribute sono esposti i membri seguenti.

Costruttori

	Nome	Descrizione
	SafeToPrepareAttribute	Inizializza una nuova istanza della classe SafeToPrepareAttribute.

Torna all'inizio

Proprietà

	Nome	Descrizione
	IsSafeToPrepare	Ottiene un valore che indica se il metodo associato è sicuro per l'esecuzione con la proprietà ExecuteForPrepare impostata su true.
	TypeId	Ereditato da Attribute.

Torna all'inizio

Metodi

	Nome	Descrizione
	{dtor}	Rilascia tutte le risorse utilizzate da SafeToPrepareAttribute.
	Equals	Ereditato da Attribute.
	GetHashCode	Ereditato da Attribute.
	GetType	Ereditato da Object.
	IsDefaultAttribute	Ereditato da Attribute.
	Match	Ereditato da Attribute.
	ToString	Ereditato da Object.

Torna all'inizio

Implementazioni esplicite dell'interfaccia

	Nome	Descrizione
	System#Runtime#InteropServices#_Attribute#GetIDsOfNames	Ereditato da Attribute.
	System#Runtime#InteropServices#_Attribute#GetTypeInfo	Ereditato da Attribute.
	System#Runtime#InteropServices#_Attribute#GetTypeInfoCount	Ereditato da Attribute.
	System#Runtime#InteropServices#_Attribute#Invoke	Ereditato da Attribute.

Torna all'inizio

Osservazioni

Se una funzione definita dall'utente restituisce un oggetto DataTable, deve essere in grado di eseguire la preparazione dell'esecuzione effettuando l'esecuzione con la proprietà ExecuteForPrepare impostata su true. Per preparare l'esecuzione, la funzione definita dall'utente deve determinare la struttura dell'oggetto DataTable che deve essere restituita e restituire un oggetto DataTable vuoto strutturato in modo appropriato.

Esempi

Nell'esempio seguente una funzione definita dall'utente semplice crea un oggetto DataTable. Se la funzione definita dall'utente effettua l'esecuzione con la proprietà ExecuteForPrepare impostata su true, restituisce una versione vuota dell'oggetto DataTable. Se la funzione definita dall'utente effettua l'esecuzione con la proprietà ExecuteForPrepare impostata su false, la funzione continua, popola l'oggetto DataTable e restituisce un oggetto DataTable popolato.

[SafeToPrepare(true)]
public System.Data.DataTable GetPreparedTable()
{
    System.Data.DataTable results = new System.Data.DataTable();
    results.Columns.Add("A", typeof(int));
    results.Columns.Add("B", typeof(string));

    if (Context.ExecuteForPrepare)
    {
        // If preparing, return just the schema with no data
        return results;
    }

    //Otherwise return data
    object[] row = new object[2];
    row[0] = 1;
    row[1] = "A";
    results.Rows.Add(row);

    row[0] = 2;
    row[1] = "B";
    results.Rows.Add(row);

    return results;
}

Protezione dei thread

I membri static (Shared in Visual Basic) pubblici di questo tipo sono affidabili. Non è invece garantita la sicurezza dei membri dell'istanza.

Vedere anche

Riferimento

Spazio dei nomi Microsoft.AnalysisServices.AdomdServer