The InitArgs class is the bridge through which initialization arguments are passed from the classes that create instances to the objects that are being created (called clients).<\/p>\n
Note that in most cases you don\u2019t need to use InitArgs directly; all of the various methods provided for initializing instances with arguments<\/a> already handle this for you behind the scenes. But for those less common scenarios where you want to write your own code that makes use of the InitArgs you can find details about its inner workings below.<\/p>\n The InitArgs.Set method can be used to store up to twelve initialization arguments for a client of a specific type, which the client can subsequently receive during its initialization.<\/p>\n The client class must implement an IInitializable<T…><\/a> or IArgs<T…><\/a> interface with generic argument types matching the types of the parameters being passed in order for it to be targetable by the InitArgs.Set method.<\/p>\n The InitArgs.TryGet method can be used by a client object to retrieve arguments stored in InitArgs during its initialization phase.<\/p>\n Use the Context argument to specify the method context from which InitArgs is being called, for example Context.Awake when calling during the Awake event or Context.Reset when calling during the Reset event.<\/p>\n Use InitArgs.Clear to release the arguments stored for a client from memory. This can be done by the class that provided the arguments for the client, after the client has been initialized.<\/p>\n If the stored arguments were never acquired by any client, then InitArgs.Clear will return true<\/strong>. In this case you can throw an InitArgumentsNotReceivedException <\/span>or log an error if you want.<\/p>\n If you need to determine separately whether or not initialization arguments stored using InitArgs.Set<\/em> have been acquired by any client yet, you can check this using InitArgs.Received<\/em>.<\/p>\n The InitArgs class is the bridge through which initialization arguments are passed from the classes that create instances to the objects that are being created (called clients). Note that in most cases you don\u2019t need to use InitArgs directly; all of the various methods provided for initializing instances with arguments already handle this for you ..<\/p>\nInitArgs.Set<\/h2>\n
InitArgs.<\/span>Set<<\/span>TClient,<\/span> TArgument>(<\/span>argument)<\/span>;<\/span><\/span><\/pre>\nInitArgs.TryGet<\/h2>\n
if<\/b><\/span>(<\/span>InitArgs.<\/span>TryGet(<\/span>Context.<\/span>Awake,<\/span> this<\/b><\/span>,<\/span> out<\/b><\/span> TArgument argument))<\/span><\/span>\r\n{<\/span>\r\n Init(<\/span>argument)<\/span>;<\/span><\/span>\r\n}<\/span><\/pre>\nInitArgs.Clear<\/h2>\n
if<\/b><\/span>(<\/span>InitArgs.<\/span>Clear<<\/span>TClient,<\/span> TArgument><\/span>(<\/span>))<\/span><\/span>\r\n{<\/span>\r\n throw new <\/b><\/span>InitArgumentsNotReceivedException(typeof<\/b><\/span>(TClient));<\/span><\/span>\r\n}<\/span><\/pre>\nInitArgs.Received<\/h2>\n
while<\/b><\/span>(<\/span>!InitArgs.<\/span>Received<<\/span>TClient,<\/span> TArgument><\/span>(<\/span>))<\/span><\/span>\r\n{<\/span>\r\n yield return<\/b><\/span> null;<\/span><\/span>\r\n}<\/span><\/pre>\n","protected":false},"excerpt":{"rendered":"