ContextUtil Class

Definition

Ruft Informationen über den COM+-Objektkontext ab.Obtains information about the COM+ object context. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

public ref class ContextUtil sealed
public sealed class ContextUtil
type ContextUtil = class
Public NotInheritable Class ContextUtil
Inheritance
ContextUtil

Examples

Im folgenden Codebeispiel wird veranschaulicht, wie ContextUtil zum Erstellen eines transaktionalen ServicedComponentverwendet wird.The following code example demonstrates how to use ContextUtil to create a transactional ServicedComponent.


[assembly:System::Reflection::AssemblyKeyFile("Transaction.snk")];
[Transaction]
public ref class TransactionalComponent: public ServicedComponent
{
public:
   void TransactionalMethod( String^ data )
   {
      ContextUtil::DeactivateOnReturn = true;
      ContextUtil::MyTransactionVote = TransactionVote::Abort;
      
      // do work with data
      ContextUtil::MyTransactionVote = TransactionVote::Commit;
   }

};

[Transaction]
public class TransactionalComponent : ServicedComponent
{

    public void TransactionalMethod (string data)
    {

      ContextUtil.DeactivateOnReturn = true;
      ContextUtil.MyTransactionVote = TransactionVote.Abort;

      // Do work with data. Return if any errors occur.

      // Vote to commit. If any errors occur, this code will not execute.
      ContextUtil.MyTransactionVote = TransactionVote.Commit;
    }
}
<Transaction()>  _
Public Class TransactionalComponent
    Inherits ServicedComponent
    
    
    Public Sub TransactionalMethod(ByVal data As String) 
        
        ContextUtil.DeactivateOnReturn = True
        ContextUtil.MyTransactionVote = TransactionVote.Abort
        
        ' Do work with data. Return if any errors occur.
        ' Vote to commit. If any errors occur, this code will not execute.
        ContextUtil.MyTransactionVote = TransactionVote.Commit
    
    End Sub
End Class

Remarks

ContextUtil ist die bevorzugte Klasse, die zum Abrufen von com+-Kontextinformationen verwendet werden kann.ContextUtil is the preferred class to use for obtaining COM+ context information. Da die Member dieser Klasse alle static (shared in Visual Basic) sind, ist es nicht notwendig, Sie vor der Verwendung zu instanziieren.Because the members of this class are all static (shared in Visual Basic), it is not necessary to instantiate it before using them.

Properties

ActivityId

Ruft eine GUID ab, die die Aktivität darstellt, in der die Komponente enthalten ist.Gets a GUID representing the activity containing the component.

ApplicationId

Ruft eine GUID für die aktuelle Anwendung ab.Gets a GUID for the current application.

ApplicationInstanceId

Ruft eine GUID für die aktuelle Anwendungsinstanz ab.Gets a GUID for the current application instance.

ContextId

Ruft eine GUID für den aktuellen Kontext ab.Gets a GUID for the current context.

DeactivateOnReturn

Ruft das done-Bit im COM+-Kontext ab oder legt dieses fest.Gets or sets the done bit in the COM+ context.

IsInTransaction

Ruft einen Wert ab, der angibt, ob der aktuelle Kontext transaktional ist.Gets a value that indicates whether the current context is transactional.

IsSecurityEnabled

Ruft einen Wert ab, der angibt, ob im aktuellen Kontext die rollenbasierte Sicherheit aktiviert ist.Gets a value that indicates whether role-based security is active in the current context.

MyTransactionVote

Ruft das consistent-Bit im COM+-Kontext ab oder legt dieses fest.Gets or sets the consistent bit in the COM+ context.

PartitionId

Ruft eine GUID für die aktuelle Partition ab.Gets a GUID for the current partition.

SystemTransaction

Ruft den aktuellen Transaktionskontext ab.Gets the current transaction context.

Transaction

Ruft ein Objekt ab, das die aktuelle COM+-DTC-Transaktion beschreibt.Gets an object describing the current COM+ DTC transaction.

TransactionId

Ruft die GUID der aktuellen COM+-DTC-Transaktion ab.Gets the GUID of the current COM+ DTC transaction.

Methods

DisableCommit()

Legt sowohl das consistent-Bit als auch das done-Bit im COM+-Kontext auf false fest.Sets both the consistent bit and the done bit to false in the COM+ context.

EnableCommit()

Legt im COM+-Kontext das consistent-Bit auf true und das done-Bit auf false fest.Sets the consistent bit to true and the done bit to false in the COM+ context.

Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetNamedProperty(String)

Gibt eine benannte Eigenschaft aus dem COM+-Kontext zurück.Returns a named property from the COM+ context.

GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
IsCallerInRole(String)

Bestimmt, ob sich der Aufrufer in der angegebenen Rolle befindet.Determines whether the caller is in the specified role.

IsDefaultContext()

Bestimmt, ob die Serviced Component im Standardkontext aktiviert ist.Determines whether the serviced component is activated in the default context. Serviced Components, die keine COM+-Kataloginformationen aufweisen, sind im Standardkontext aktiviert.Serviced components that do not have COM+ catalog information are activated in the default context.

MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
SetAbort()

Legt im COM+-Kontext das consistent-Bit auf false und das done-Bit auf true fest.Sets the consistent bit to false and the done bit to true in the COM+ context.

SetComplete()

Legt das consistent-Bit und das done-Bit im COM+-Kontext auf true fest.Sets the consistent bit and the done bit to true in the COM+ context.

SetNamedProperty(String, Object)

Legt die benannte Eigenschaft für den COM+-Kontext fest.Sets the named property for the COM+ context.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Applies to