RemotingServices.GetObjRefForProxy(MarshalByRefObject) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Retourneert het ObjRef externe object van de opgegeven proxy.
public:
static System::Runtime::Remoting::ObjRef ^ GetObjRefForProxy(MarshalByRefObject ^ obj);public static System.Runtime.Remoting.ObjRef GetObjRefForProxy(MarshalByRefObject obj);[System.Security.SecurityCritical]
public static System.Runtime.Remoting.ObjRef GetObjRefForProxy(MarshalByRefObject obj);static member GetObjRefForProxy : MarshalByRefObject -> System.Runtime.Remoting.ObjRef[<System.Security.SecurityCritical>]
static member GetObjRefForProxy : MarshalByRefObject -> System.Runtime.Remoting.ObjRefPublic Shared Function GetObjRefForProxy (obj As MarshalByRefObject) As ObjRefParameters
Een proxy die is verbonden met het object waarvoor u een ObjRef wilt maken.
Retouren
Een ObjRef die het externe object vertegenwoordigt waarmee de opgegeven proxy is verbonden, of null als het object of de proxy niet is marshaled.
- Kenmerken
Uitzonderingen
De directe beller heeft geen infrastructuurmachtiging.
Voorbeelden
In het volgende codevoorbeeld ziet u hoe u een ObjRef exemplaar voor het opgegeven object kunt ophalen.
ObjRef^ objRefSample = RemotingServices::GetObjRefForProxy( myRemoteObject );
Console::WriteLine( "***ObjRef Details***" );
Console::WriteLine( "URI:\t {0}", objRefSample->URI );
array<Object^>^channelData = objRefSample->ChannelInfo->ChannelData;
Console::WriteLine( "Channel Info:" );
IEnumerator^ myEnum = channelData->GetEnumerator();
while ( myEnum->MoveNext() )
{
Object^ o = safe_cast<Object^>(myEnum->Current);
Console::WriteLine( "\t {0}", o );
}
IEnvoyInfo^ envoyInfo = objRefSample->EnvoyInfo;
if ( envoyInfo == nullptr )
{
Console::WriteLine( "This ObjRef does not have envoy information." );
}
else
{
IMessageSink^ envoySinks = envoyInfo->EnvoySinks;
Console::WriteLine( "Envoy Sink Class: {0}", envoySinks );
}
IRemotingTypeInfo^ typeInfo = objRefSample->TypeInfo;
Console::WriteLine( "Remote type name: {0}", typeInfo->TypeName );
Console::WriteLine( "Can my Object* cast to a Bitmap? {0}", typeInfo->CanCastTo( System::Drawing::Bitmap::typeid, objRefSample ) );
ObjRef objRefSample = RemotingServices.GetObjRefForProxy(myRemoteObject);
Console.WriteLine("***ObjRef Details***");
Console.WriteLine("URI:\t{0}", objRefSample.URI);
object[] channelData = objRefSample.ChannelInfo.ChannelData;
Console.WriteLine("Channel Info:");
foreach(object o in channelData)
Console.WriteLine("\t{0}", o.ToString());
IEnvoyInfo envoyInfo = objRefSample.EnvoyInfo;
if (envoyInfo == null) {
Console.WriteLine("This ObjRef does not have envoy information.");
}
else {
IMessageSink envoySinks = envoyInfo.EnvoySinks;
Console.WriteLine("Envoy Sink Class: {0}", envoySinks);
}
IRemotingTypeInfo typeInfo = objRefSample.TypeInfo;
Console.WriteLine("Remote type name: {0}", typeInfo.TypeName);
Console.WriteLine("Can my object cast to a Bitmap? {0}",
typeInfo.CanCastTo(typeof(System.Drawing.Bitmap), objRefSample));
Dim objRefSample As ObjRef = RemotingServices.GetObjRefForProxy(myRemoteObject)
Console.WriteLine("***ObjRef Details***")
Console.WriteLine("URI:" + ControlChars.Tab + "{0}", objRefSample.URI)
Dim channelData As Object() = objRefSample.ChannelInfo.ChannelData
Console.WriteLine("Channel Info:")
Dim o As Object
For Each o In channelData
Console.WriteLine(ControlChars.Tab + "{0}", o.ToString())
Next o
Dim envoyInfo As IEnvoyInfo = objRefSample.EnvoyInfo
If envoyInfo Is Nothing Then
Console.WriteLine("This ObjRef does not have envoy information.")
Else
Dim envoySinks As IMessageSink = envoyInfo.EnvoySinks
Console.WriteLine("Envoy Sink Class: {0}", envoySinks)
End If
Dim typeInfo As IRemotingTypeInfo = objRefSample.TypeInfo
Console.WriteLine("Remote type name: {0}", typeInfo.TypeName)
Console.WriteLine("Can my object cast to a Bitmap? {0}", typeInfo.CanCastTo(GetType(System.Drawing.Bitmap), objRefSample))
Opmerkingen
A ObjRef is een serialiseerbare weergave van een object dat wordt gebruikt om een objectverwijzing over een toepassingsdomeingrens over te dragen. Het maken van een ObjRef voor een object wordt marshaling genoemd. De ObjRef kan via een kanaal worden overgebracht naar een ander toepassingsdomein (mogelijk op een ander proces of op een andere computer). Eenmaal in het andere toepassingsdomein moet de ObjRef toepassing worden geparseerd om een proxy te maken voor het object, meestal verbonden met het echte object. Deze bewerking wordt unmarshaling genoemd. Tijdens niet-marshaling wordt de ObjRef methode-informatie van het externe object geparseerd en worden zowel de transparante proxy als RealProxy de objecten gemaakt.
Een ObjRef bevat informatie over de Type en klasse van het object dat wordt marshaled, een URI die het specifieke objectexemplaren uniek identificeert en communicatiegerelateerde informatie over het bereiken van de externe toepassing waar het object zich bevindt.
