CallContext Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Fornisce un set di proprietà che vengono trasportate con il percorso del codice di esecuzione. Questa classe non può essere ereditata.
public ref class CallContext sealed
[System.Serializable]
public sealed class CallContext
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class CallContext
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
[System.Security.SecurityCritical]
public sealed class CallContext
[<System.Serializable>]
type CallContext = class
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type CallContext = class
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
[<System.Security.SecurityCritical>]
type CallContext = class
Public NotInheritable Class CallContext
- Ereditarietà
-
CallContext
- Attributi
Esempio
Nell'esempio di codice seguente viene illustrato l'uso della CallContext classe per trasmettere oggetti Principal e Identity a una posizione remota per l'identificazione. Per visualizzare il codice per la LogicalCallContextData classe usata in questo esempio, vedere l'esempio per l'interfaccia ILogicalThreadAffinative . Per visualizzare il codice per la HelloServiceClass classe usata in questo esempio, vedere l'esempio per il GetData metodo . Per visualizzare il codice per la classe server usata in questo esempio, vedere l'esempio per la RegisterActivatedServiceType classe .
#using <system.dll>
#using <system.runtime.remoting.dll>
#using <service.dll>
using namespace System;
using namespace System::Runtime::Remoting;
using namespace System::Runtime::Remoting::Channels;
using namespace System::Runtime::Remoting::Channels::Tcp;
using namespace System::Runtime::Remoting::Messaging;
using namespace System::Security::Principal;
int main()
{
GenericIdentity^ ident = gcnew GenericIdentity( "Bob" );
array<String^>^id = gcnew array<String^>(1);
id[ 0 ] = "Level1";
GenericPrincipal^ prpal = gcnew GenericPrincipal( ident,id );
LogicalCallContextData ^ data = gcnew LogicalCallContextData( prpal );
//Enter data into the CallContext
CallContext::SetData( "test data", data );
Console::WriteLine( data->numOfAccesses );
ChannelServices::RegisterChannel( gcnew TcpChannel );
RemotingConfiguration::RegisterActivatedClientType( HelloServiceClass::typeid, "tcp://localhost:8082" );
HelloServiceClass ^ service = gcnew HelloServiceClass;
if ( service == nullptr )
{
Console::WriteLine( "Could not locate server." );
return 0;
}
// call remote method
Console::WriteLine();
Console::WriteLine( "Calling remote Object*" );
Console::WriteLine( service->HelloMethod( "Caveman" ) );
Console::WriteLine( service->HelloMethod( "Spaceman" ) );
Console::WriteLine( service->HelloMethod( "Bob" ) );
Console::WriteLine( "Finished remote Object* call" );
Console::WriteLine();
//Extract the returned data from the call context
LogicalCallContextData ^ returnedData = static_cast<LogicalCallContextData ^>(CallContext::GetData( "test data" ));
Console::WriteLine( data->numOfAccesses );
Console::WriteLine( returnedData->numOfAccesses );
return 0;
}
using System;
using System.Runtime.Remoting;
using System.Runtime.Remoting.Channels;
using System.Runtime.Remoting.Channels.Tcp;
using System.Runtime.Remoting.Messaging;
using System.Security.Principal;
using System.Security.Permissions;
public class ClientClass {
public static void Main() {
GenericIdentity ident = new GenericIdentity("Bob");
GenericPrincipal prpal = new GenericPrincipal(ident,
new string[] {"Level1"});
LogicalCallContextData data = new LogicalCallContextData(prpal);
//Enter data into the CallContext
CallContext.SetData("test data", data);
Console.WriteLine(data.numOfAccesses);
ChannelServices.RegisterChannel(new TcpChannel());
RemotingConfiguration.RegisterActivatedClientType(typeof(HelloServiceClass),
"tcp://localhost:8082");
HelloServiceClass service = new HelloServiceClass();
if(service == null) {
Console.WriteLine("Could not locate server.");
return;
}
// call remote method
Console.WriteLine();
Console.WriteLine("Calling remote object");
Console.WriteLine(service.HelloMethod("Caveman"));
Console.WriteLine(service.HelloMethod("Spaceman"));
Console.WriteLine(service.HelloMethod("Bob"));
Console.WriteLine("Finished remote object call");
Console.WriteLine();
//Extract the returned data from the call context
LogicalCallContextData returnedData =
(LogicalCallContextData)CallContext.GetData("test data");
Console.WriteLine(data.numOfAccesses);
Console.WriteLine(returnedData.numOfAccesses);
}
}
Imports System.Runtime.Remoting
Imports System.Runtime.Remoting.Channels
Imports System.Runtime.Remoting.Channels.Tcp
Imports System.Runtime.Remoting.Messaging
Imports System.Security.Principal
Imports System.Security.Permissions
Public Class ClientClass
<PermissionSet(SecurityAction.LinkDemand)> _
Public Shared Sub Main()
Dim ident As New GenericIdentity("Bob")
Dim prpal As New GenericPrincipal(ident, New String() {"Level1"})
Dim data As New LogicalCallContextData(prpal)
'Enter data into the CallContext
CallContext.SetData("test data", data)
Console.WriteLine(data.numOfAccesses)
ChannelServices.RegisterChannel(New TcpChannel())
RemotingConfiguration.RegisterActivatedClientType(GetType(HelloServiceClass), "tcp://localhost:8082")
Dim service As New HelloServiceClass()
If service Is Nothing Then
Console.WriteLine("Could not locate server.")
Return
End If
' call remote method
Console.WriteLine()
Console.WriteLine("Calling remote object")
Console.WriteLine(service.HelloMethod("Caveman"))
Console.WriteLine(service.HelloMethod("Spaceman"))
Console.WriteLine(service.HelloMethod("Bob"))
Console.WriteLine("Finished remote object call")
Console.WriteLine()
'Extract the returned data from the call context
Dim returnedData As LogicalCallContextData = CType(CallContext.GetData("test data"), LogicalCallContextData)
Console.WriteLine(data.numOfAccesses)
Console.WriteLine(returnedData.numOfAccesses)
End Sub
End Class
Commenti
CallContext è un oggetto di raccolta specializzato simile a un'archiviazione locale thread per le chiamate al metodo e fornisce slot di dati univoci per ogni thread logico di esecuzione. Gli slot non vengono condivisi tra contesti di chiamata in altri thread logici. Gli oggetti possono essere aggiunti all'oggetto CallContext durante il viaggio verso il basso e il backup del percorso del codice di esecuzione ed esaminati da vari oggetti lungo il percorso.
Quando viene effettuata una chiamata al metodo remoto a un oggetto in un altro AppDomainoggetto , la CallContext classe genera un'istanza LogicalCallContext che viaggia insieme alla chiamata remota. Solo gli oggetti che espongono l'interfaccia ILogicalThreadAffinative e vengono archiviati in vengono propagati all'esterno CallContext di AppDomain in un oggetto LogicalCallContext. Gli oggetti che non supportano questa interfaccia non vengono trasmessi nelle LogicalCallContext istanze con chiamate al metodo remoto.
Note
Tutti i metodi in CallContext sono statici e operano sul contesto di chiamata nell'oggetto corrente Thread.
Note
Questa classe effettua una richiesta di collegamento. Viene SecurityException generata un'eccezione se il chiamante immediato non dispone dell'autorizzazione dell'infrastruttura.
Proprietà
| Nome | Descrizione |
|---|---|
| HostContext |
Ottiene o imposta il contesto host associato al thread corrente. |
Metodi
| Nome | Descrizione |
|---|---|
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| FreeNamedDataSlot(String) |
Svuota uno slot di dati con il nome specificato. |
| GetData(String) |
Recupera un oggetto con il nome specificato da CallContext. |
| GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
| GetHeaders() |
Restituisce le intestazioni inviate insieme alla chiamata al metodo . |
| GetType() |
Ottiene il Type dell'istanza corrente. (Ereditato da Object) |
| LogicalGetData(String) |
Recupera un oggetto con il nome specificato dal contesto di chiamata logica. |
| LogicalSetData(String, Object) |
Archivia un determinato oggetto nel contesto di chiamata logica e lo associa al nome specificato. |
| MemberwiseClone() |
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
| SetData(String, Object) |
Archivia un determinato oggetto e lo associa al nome specificato. |
| SetHeaders(Header[]) |
Imposta le intestazioni inviate insieme alla chiamata al metodo. |
| ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |