MarshalByRefObject.CreateObjRef Method (System)

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2010/.NET Framework 4

Other versions are also available for the following:

.NET Framework Class Library

MarshalByRefObject..::.CreateObjRef Method

Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

Namespace: System
Assembly: mscorlib (in mscorlib.dll)

Syntax

Visual Basic

Public Overridable Function CreateObjRef ( _
    requestedType As Type _
) As ObjRef

public virtual ObjRef CreateObjRef(
    Type requestedType
)

Visual C++

public:
virtual ObjRef^ CreateObjRef(
    Type^ requestedType
)

abstract CreateObjRef : 
        requestedType:Type -> ObjRef 
override CreateObjRef : 
        requestedType:Type -> ObjRef

Parameters

requestedType: Type: System..::.Type
The Type of the object that the new ObjRef will reference.

Return Value

Type: System.Runtime.Remoting..::.ObjRef
Information required to generate a proxy.

Exceptions

Exception	Condition
RemotingException	This instance is not a valid remoting object.
SecurityException	The immediate caller does not have infrastructure permission.

Remarks

The CreateObjRef method is called by remote object creation methods such as AppDomain..::.CreateInstance and AppDomain..::.CreateInstanceAndUnwrap. In most cases, there is no need to override this method.

Version Information

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

.NET Framework Security

SecurityCriticalAttribute
requires full trust for the immediate caller. This member cannot be used by partially trusted or transparent code.

Platforms

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Reference

MarshalByRefObject Class

System Namespace