ObjRef 클래스
원격 개체와 통신하려면 프록시를 생성하는 데 필요한 모든 관련 정보를 저장합니다.
네임스페이스: System.Runtime.Remoting
어셈블리: mscorlib(mscorlib.dll)
구문
‘선언
<SerializableAttribute> _
<ComVisibleAttribute(True)> _
Public Class ObjRef
Implements IObjectReference, ISerializable
‘사용 방법
Dim instance As ObjRef
[SerializableAttribute]
[ComVisibleAttribute(true)]
public class ObjRef : IObjectReference, ISerializable
[SerializableAttribute]
[ComVisibleAttribute(true)]
public ref class ObjRef : IObjectReference, ISerializable
/** @attribute SerializableAttribute() */
/** @attribute ComVisibleAttribute(true) */
public class ObjRef implements IObjectReference, ISerializable
SerializableAttribute
ComVisibleAttribute(true)
public class ObjRef implements IObjectReference, ISerializable
설명
ObjRef는 MBR(MarshalByRefObject)를 확장하는 serialize 가능한 개체 표현입니다. ObjRef는 AppDomain 경계를 넘어 개체 참조를 전송하는 데 사용합니다. 개체에 대해 ObjRef를 만드는 것을 마샬링이라고 합니다. 원격 인프라에 MBR 개체를 등록하는 명시적 방법(RemotingConfiguration 및 RemotingServices.Marshal 참조)이나 원격 개체를 호출할 때 매개 변수로 MBR 개체를 전달하는 암시적 방법으로 ObjRef를 만들 수 있습니다. 즉, MarshalByRefObject를 마샬링할 수 있습니다. 원격화 작업에서는 ObjRef 개체를 사용하여 원격화된 MarshalByRefObject에 대한 모든 관련 정보를 저장하고 전송합니다.
ObjRef에는 Type 설명 정보, 마샬링되는 개체 클래스, 해당 개체의 정확한 위치 및 해당 개체가 있는 원격 하위 영역에 연결하는 방법에 대한 통신 관련 정보가 들어 있습니다.
MarshalByRefObject를 구현하는 클래스가 마샬링된 후에는 이를 나타내는 ObjRef가 채널을 통해 다른 프로세스나 컴퓨터에 있는 다른 응용 프로그램 도메인으로 전송됩니다. ObjRef는 대상 응용 프로그램 도메인에서 deserialize(XML 및 SOAP Serialization 참조)될 때 구문 분석되어 원격 MBR 개체의 투명 프록시를 만듭니다. 이 작업을 역마샬링이라고 합니다.
투명 프록시는 실제 개체가 클라이언트의 공간에 있는 것처럼 보이게 하는 개체입니다. 이는 프록시가 자신에 대한 호출을 원격 인프라를 사용하여 실제 개체로 전달하기 때문에 가능합니다. 투명 프록시는 RealProxy 형식의 관리되는 런타임 클래스의 인스턴스를 자체 관리합니다. RealProxy는 투명 프록시로부터 작업을 전달하는 데 필요한 기능 중 일부를 구현합니다.
프록시 개체는 AppDomain 내의 원격 하위 영역에 관계없이 사용될 수 있습니다. 응용 프로그램에서는 프록시 참조와 개체 참조를 구별할 필요가 없지만 활성화, 수명 관리 및 트랜잭션 등을 처리하는 서비스 공급자는 두 참조의 차이를 알아야 합니다.
이 클래스는 클래스 수준에 링크 요청과 상속 요청을 만듭니다. 직접 실행 호출자나 파생 클래스에 인프라 권한이 없으면 SecurityException이 throw됩니다. 보안 요청에 대한 자세한 내용은 링크 요청 및 상속 요청을 참조하십시오.
예제
다음 코드 예제에서는 사용자 지정 ObjRef를 사용하는 방법을 보여 줍니다. 사용자 지정 ObjRef를 테스트하는 활성화 코드를 보려면 RegisterWellKnownServiceType 메서드의 예제를 참조하십시오.
' a custom ObjRef class that outputs its status
<PermissionSet(SecurityAction.Demand, Name:="FullTrust")> _
Public Class MyObjRef
Inherits ObjRef
' only instantiate using marshaling or deserialization
Private Sub New()
End Sub
Public Sub New(ByVal o As MarshalByRefObject, ByVal t As Type)
MyBase.New(o, t)
Console.WriteLine("Created MyObjRef.")
ORDump()
End Sub
Public Sub New(ByVal i As SerializationInfo, ByVal c As StreamingContext)
MyBase.New(i, c)
Console.WriteLine("Deserialized MyObjRef.")
End Sub
Public Overrides Sub GetObjectData(ByVal s As SerializationInfo, ByVal c As StreamingContext)
' After calling the base method, change the type from ObjRef to MyObjRef
MyBase.GetObjectData(s, c)
s.SetType([GetType]())
Console.WriteLine("Serialized MyObjRef.")
End Sub
Public Overrides Function GetRealObject(ByVal context As StreamingContext) As [Object]
If IsFromThisAppDomain() Or IsFromThisProcess() Then
Console.WriteLine("Returning actual object referenced by MyObjRef.")
Return MyBase.GetRealObject(context)
Else
Console.WriteLine("Returning proxy to remote object.")
Return RemotingServices.Unmarshal(Me)
End If
End Function
Public Sub ORDump()
Console.WriteLine(" --- Reporting MyObjRef Info --- ")
Console.WriteLine("Reference to {0}.", TypeInfo.TypeName)
Console.WriteLine("URI is {0}.", URI)
Console.WriteLine(ControlChars.Cr + "Writing EnvoyInfo: ")
If Not (EnvoyInfo Is Nothing) Then
Dim EISinks As IMessageSink = EnvoyInfo.EnvoySinks
Dim count As Integer = 0
While Not (EISinks Is Nothing)
Console.WriteLine(ControlChars.Tab + "Interated through sink #{0}", (count = count + 1))
EISinks = EISinks.NextSink
End While
Else
Console.WriteLine(ControlChars.Tab + " {no sinks}")
End If
Console.WriteLine(ControlChars.Cr + "Writing ChannelInfo: ")
Dim i As Integer
For i = 0 To ChannelInfo.ChannelData.Length - 1
Console.WriteLine(ControlChars.Tab + "Channel: {0}", ChannelInfo.ChannelData(i))
Next i
Console.WriteLine(" ----------------------------- ")
End Sub
End Class
' a class that uses MyObjRef
<PermissionSet(SecurityAction.Demand, Name:="FullTrust")> _
Public Class LocalObject
Inherits MarshalByRefObject
' overriding CreateObjRef will allow us to return a custom ObjRef
Public Overrides Function CreateObjRef(ByVal t As Type) As ObjRef
Return New MyObjRef(Me, t)
End Function
End Class
// a custom ObjRef class that outputs its status
[PermissionSet(SecurityAction.Demand, Name="FullTrust")]
public class MyObjRef : ObjRef {
// only instantiate using marshaling or deserialization
private MyObjRef() { }
public MyObjRef(MarshalByRefObject o, Type t) : base(o, t) {
Console.WriteLine("Created MyObjRef.");
ORDump();
}
public MyObjRef(SerializationInfo i, StreamingContext c) : base(i, c) {
Console.WriteLine("Deserialized MyObjRef.");
}
public override void GetObjectData(SerializationInfo s, StreamingContext c) {
// After calling the base method, change the type from ObjRef to MyObjRef
base.GetObjectData(s, c);
s.SetType(GetType());
Console.WriteLine("Serialized MyObjRef.");
}
public override Object GetRealObject(StreamingContext context) {
if ( IsFromThisAppDomain() || IsFromThisProcess() ) {
Console.WriteLine("Returning actual object referenced by MyObjRef.");
return base.GetRealObject(context);
}
else {
Console.WriteLine("Returning proxy to remote object.");
return RemotingServices.Unmarshal(this);
}
}
public void ORDump() {
Console.WriteLine(" --- Reporting MyObjRef Info --- ");
Console.WriteLine("Reference to {0}.", TypeInfo.TypeName);
Console.WriteLine("URI is {0}.", URI);
Console.WriteLine("\nWriting EnvoyInfo: ");
if ( EnvoyInfo != null) {
IMessageSink EISinks = EnvoyInfo.EnvoySinks;
while (EISinks != null) {
Console.WriteLine("\tSink: " + EISinks.ToString());
EISinks = EISinks.NextSink;
}
}
else
Console.WriteLine("\t {no sinks}");
Console.WriteLine("\nWriting ChannelInfo: ");
for (int i = 0; i < ChannelInfo.ChannelData.Length; i++)
Console.WriteLine ("\tChannel: {0}", ChannelInfo.ChannelData[i]);
Console.WriteLine(" ----------------------------- ");
}
}
// a class that uses MyObjRef
[PermissionSet(SecurityAction.Demand, Name="FullTrust")]
public class LocalObject : MarshalByRefObject {
// overriding CreateObjRef will allow us to return a custom ObjRef
public override ObjRef CreateObjRef(Type t) {
return new MyObjRef(this, t);
}
}
// a custom ObjRef class that outputs its status
[System::Security::Permissions::SecurityPermissionAttribute(
System::Security::Permissions::SecurityAction::Demand,
Flags=System::Security::Permissions::SecurityPermissionFlag::SerializationFormatter)]
[System::Security::Permissions::SecurityPermissionAttribute
(System::Security::Permissions::SecurityAction::Demand,
Flags=System::Security::Permissions::SecurityPermissionFlag::Infrastructure)]
[System::Security::Permissions::SecurityPermissionAttribute
(System::Security::Permissions::SecurityAction::InheritanceDemand,
Flags=System::Security::Permissions::SecurityPermissionFlag::Infrastructure)]
public ref class MyObjRef: public ObjRef
{
private:
// only instantiate using marshaling or deserialization
MyObjRef(){}
public:
MyObjRef( MarshalByRefObject^ o, Type^ t )
: ObjRef( o, t )
{
Console::WriteLine( "Created MyObjRef." );
ORDump();
}
MyObjRef( SerializationInfo^ i, StreamingContext c )
: ObjRef( i, c )
{
Console::WriteLine( "Deserialized MyObjRef." );
}
virtual void GetObjectData( SerializationInfo^ s, StreamingContext c ) override
{
// After calling the base method, change the type from ObjRef to MyObjRef
ObjRef::GetObjectData( s, c );
s->SetType( GetType() );
Console::WriteLine( "Serialized MyObjRef." );
}
virtual Object^ GetRealObject( StreamingContext context ) override
{
if ( IsFromThisAppDomain() || IsFromThisProcess() )
{
Console::WriteLine( "Returning actual Object^ referenced by MyObjRef." );
return ObjRef::GetRealObject( context );
}
else
{
Console::WriteLine( "Returning proxy to remote Object^." );
return RemotingServices::Unmarshal( this );
}
}
void ORDump()
{
Console::WriteLine( " --- Reporting MyObjRef Info --- " );
Console::WriteLine( "Reference to {0}.", TypeInfo->TypeName );
Console::WriteLine( "URI is {0}.", URI );
Console::WriteLine( "\nWriting EnvoyInfo: " );
if ( EnvoyInfo != nullptr )
{
IMessageSink^ EISinks = EnvoyInfo->EnvoySinks;
while ( EISinks != nullptr )
{
Console::WriteLine( "\tSink: {0}", EISinks );
EISinks = EISinks->NextSink;
}
}
else
Console::WriteLine( "\t {no sinks}" );
Console::WriteLine( "\nWriting ChannelInfo: " );
for ( int i = 0; i < ChannelInfo->ChannelData->Length; i++ )
Console::WriteLine( "\tChannel: {0}", ChannelInfo->ChannelData[ i ] );
Console::WriteLine( " ----------------------------- " );
}
};
// a class that uses MyObjRef
public ref class LocalObject: public MarshalByRefObject
{
public:
// overriding CreateObjRef will allow us to return a custom ObjRef
[System::Security::Permissions::SecurityPermissionAttribute
(System::Security::Permissions::SecurityAction::LinkDemand,
Flags=System::Security::Permissions::SecurityPermissionFlag::Infrastructure)]
virtual ObjRef^ CreateObjRef( Type^ t ) override
{
return gcnew MyObjRef( this,t );
}
};
.NET Framework 보안
- SecurityPermission 인프라 코드를 사용하여 작업하는 데 필요한 권한입니다. 요청 값: SecurityAction.LinkDemand, 권한 값: SecurityPermissionFlag.Infrastructure
- SecurityPermission 인프라 코드를 사용하여 작업하는 데 필요한 권한입니다. 요청 값: SecurityAction.InheritanceDemand, 권한 값: SecurityPermissionFlag.Infrastructure
상속 계층 구조
System.Object
System.Runtime.Remoting.ObjRef
스레드로부터의 안전성
이 형식의 모든 public static(Visual Basic의 경우 Shared) 멤버는 스레드로부터 안전합니다. 인터페이스 멤버는 스레드로부터 안전하지 않습니다.
플랫폼
Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework에서 모든 플래폼의 모든 버전을 지원하지는 않습니다. 지원되는 버전의 목록은 시스템 요구 사항을 참조하십시오.
버전 정보
.NET Framework
2.0, 1.1, 1.0에서 지원
참고 항목
참조
ObjRef 멤버
System.Runtime.Remoting 네임스페이스
ISerializable
RemotingServices.Marshal
RemotingServices.Unmarshal
RealProxy