diff --git a/xml/System/Activator.xml b/xml/System/Activator.xml index 79f5bfbc541..3a39902edc3 100644 --- a/xml/System/Activator.xml +++ b/xml/System/Activator.xml @@ -157,7 +157,7 @@ The name of a file that contains an assembly where the type named is sought. The name of the type to create an instance of. Creates an instance of the COM object whose name is specified, using the named assembly file and the parameterless constructor. - A handle that must be unwrapped to access the newly created instance. + A handle that must be unwrapped to access the newly created object, or for instances. The value of the computed hash code. The hash algorithm used for hashing files and generating the strong name. Creates an instance of the COM object whose name is specified, using the named assembly file and the parameterless constructor. - A handle that must be unwrapped to access the newly created instance. + A handle that must be unwrapped to access the newly created object, or for instances. An activation context object that specifies the object to create. Creates an instance of the type designated by the specified object. - A handle that must be unwrapped to access the newly created object. + A handle that must be unwrapped to access the newly created object, or for instances. instances. - +## Remarks Use the method to unwrap the return value. The activation context is used during manifest-based activation to set up the domain policy and to provide an application-based security model. The class contains an object that provides access to the application manifest. For more information, see the class. @@ -401,15 +399,13 @@ The type of object to create. Creates an instance of the specified type using that type's parameterless constructor. - A reference to the newly created object. + A reference to the newly created object, or for instances. instances. - > [!NOTE] > Starting with .NET Framework 2.0, this method can be used to access nonpublic types if the caller has been granted with the flag and if the grant set of the assembly that contains the nonpublic types is restricted to the caller's grant set or to a subset thereof. (See [Security Considerations for Reflection](/dotnet/framework/reflection-and-codedom/security-considerations-for-reflection).) To use this functionality, your application should target .NET Framework 3.5 or later. @@ -497,7 +493,7 @@ Note: In .NET for Win An activation context object that specifies the object to create. An array of Unicode strings that contain custom activation data. Creates an instance of the type that is designated by the specified object and activated with the specified custom activation data. - A handle that must be unwrapped to access the newly created object. + A handle that must be unwrapped to access the newly created object, or for instances. .NET for Win The name of the assembly where the type named is sought. If is , the executing assembly is searched. The fully qualified name of the type to create an instance of. Creates an instance of the type whose name is specified, using the named assembly and parameterless constructor. - A handle that must be unwrapped to access the newly created instance. + A handle that must be unwrapped to access the newly created object, or for instances. instances. - +## Remarks Use to unwrap the return value. `assemblyName` can be either of the following: @@ -681,14 +675,12 @@ Note: In .NET for Win if a public or nonpublic parameterless constructor can match; if only a public parameterless constructor can match. Creates an instance of the specified type using that type's parameterless constructor. - A reference to the newly created object. + A reference to the newly created object, or for instances. instances. - > [!NOTE] > Starting with .NET Framework 2.0, this method can be used to access nonpublic types and members if the caller has been granted with the flag and if the grant set of the assembly that contains the nonpublic types and members is restricted to the caller's grant set or to a subset thereof. (See [Security Considerations for Reflection](/dotnet/framework/reflection-and-codedom/security-considerations-for-reflection).) To use this functionality, your application should target .NET Framework 3.5 or later. @@ -800,15 +792,13 @@ Note: In .NET for Win The type of object to create. An array of arguments that match in number, order, and type the parameters of the constructor to invoke. If is an empty array or , the constructor that takes no parameters (the parameterless constructor) is invoked. Creates an instance of the specified type using the constructor that best matches the specified parameters. - A reference to the newly created object. + A reference to the newly created object, or for instances with no value. instances with no value. - + > [!NOTE] > Starting with .NET Framework 2.0, this method can be used to access nonpublic types if the caller has been granted with the flag and if the grant set of the assembly that contains the nonpublic types is restricted to the caller's grant set or to a subset thereof. (See [Security Considerations for Reflection](/dotnet/framework/reflection-and-codedom/security-considerations-for-reflection).) To use this functionality, your application should target .NET Framework 3.5 or later. @@ -907,13 +897,11 @@ Note: In .NET for Win The name of the assembly where the type named is sought. If is , the executing assembly is searched. The fully qualified name of the type to create an instance of. Creates an instance of the type whose name is specified in the specified remote domain, using the named assembly and parameterless constructor. - A handle that must be unwrapped to access the newly created instance. + A handle that must be unwrapped to access the newly created object, or for instances. instances. - +## Remarks Use when a host needs to execute code in an application domain that has restricted security permissions. Use to unwrap the return value. @@ -1009,13 +997,11 @@ Note: In .NET for Win This parameter is related to client-activated objects. Client activation is a legacy technology that is retained for backward compatibility but is not recommended for new development. Distributed applications should instead use Windows Communication Foundation. Creates an instance of the type whose name is specified, using the named assembly and parameterless constructor. - A handle that must be unwrapped to access the newly created instance. + A handle that must be unwrapped to access the newly created object, or for instances. instances. - +## Remarks Use to unwrap the return value. > [!NOTE] @@ -1129,15 +1115,13 @@ An error occurred when attempting remote activation in a target specified in Creates an instance of the specified type using the constructor that best matches the specified parameters. - A reference to the newly created object. + A reference to the newly created object, or for instances with no value. instances with no value. - + > [!NOTE] > Starting with .NET Framework 2.0, this method can be used to access nonpublic types if the caller has been granted with the flag and if the grant set of the assembly that contains the nonpublic types is restricted to the caller's grant set or to a subset thereof. (See [Security Considerations for Reflection](/dotnet/framework/reflection-and-codedom/security-considerations-for-reflection).) To use this functionality, your application should target .NET Framework 3.5 or later. @@ -1249,15 +1233,13 @@ An error occurred when attempting remote activation in a target specified in An array of arguments that match in number, order, and type the parameters of the constructor to invoke. If is an empty array or , the constructor that takes no parameters (the parameterless constructor) is invoked. Culture-specific information that governs the coercion of to the formal types declared for the constructor. If is , the for the current thread is used. Creates an instance of the specified type using the constructor that best matches the specified parameters. - A reference to the newly created object. + A reference to the newly created object, or for instances with no value. instances with no value. - + > [!NOTE] > Starting with .NET Framework 2.0, this method can be used to access nonpublic types and members if the caller has been granted with the flag and if the grant set of the assembly that contains the nonpublic types and members is restricted to the caller's grant set or to a subset thereof. (See [Security Considerations for Reflection](/dotnet/framework/reflection-and-codedom/security-considerations-for-reflection).) To use this functionality, your application should target .NET Framework 3.5 or later. @@ -1369,15 +1351,13 @@ An error occurred when attempting remote activation in a target specified in Creates an instance of the specified type using the constructor that best matches the specified parameters. - A reference to the newly created object. + A reference to the newly created object, or for instances with no value. instances with no value. - + > [!NOTE] > Starting with .NET Framework 2.0, this method can be used to access nonpublic types and members if the caller has been granted with the flag and if the grant set of the nonpublic types and members is restricted to the caller's grant set or to a subset thereof. (See [Security Considerations for Reflection](/dotnet/framework/reflection-and-codedom/security-considerations-for-reflection).) To use this functionality, your application should target .NET Framework 3.5 or later. @@ -1500,15 +1480,13 @@ An error occurred when attempting remote activation in a target specified in Creates an instance of the type whose name is specified, using the named assembly and the constructor that best matches the specified parameters. - A handle that must be unwrapped to access the newly created instance. + A handle that must be unwrapped to access the newly created instance, or for instances with no value. to unwrap the return value. - - The method returns `null` for the instances with no value. - + > [!NOTE] > Starting with .NET Framework 2.0, this method can be used to create nonpublic types and members if the caller has been granted with the flag and if the grant set of the assembly that contains the nonpublic types and members is restricted to the caller's grant set or to a subset thereof. (See [Security Considerations for Reflection](/dotnet/framework/reflection-and-codedom/security-considerations-for-reflection).) To use this functionality, your application should target .NET Framework 3.5 or later. @@ -1600,15 +1578,13 @@ An error occurred when attempting remote activation in a target specified in Creates an instance of the type whose name is specified in the specified remote domain, using the named assembly and the constructor that best matches the specified parameters. - A handle that must be unwrapped to access the newly created instance. + A handle that must be unwrapped to access the newly created object, or for instances with no value. when a host needs to execute code in an application domain that has restricted security permissions. - - The method returns `null` for the instances with no value. - + Use to unwrap the return value. ]]> @@ -1705,13 +1681,11 @@ An error occurred when attempting remote activation in a target specified in Information used to make security policy decisions and grant code permissions. Creates an instance of the type whose name is specified, using the named assembly and the constructor that best matches the specified parameters. - A handle that must be unwrapped to access the newly created instance. + A handle that must be unwrapped to access the newly created object, or for instances with no value. instances with no value. - +## Remarks Use to unwrap the return value. > [!NOTE] @@ -1810,13 +1784,11 @@ An error occurred when attempting remote activation in a target specified in An array of one or more attributes that can participate in activation. This is typically an array that contains a single object. The specifies the URL that is required to activate a remote object. Information used to make security policy decisions and grant code permissions. Creates an instance of the type whose name is specified in the specified remote domain, using the named assembly and the constructor that best matches the specified parameters. - A handle that must be unwrapped to access the newly created instance. + A handle that must be unwrapped to access the newly created object, or for instances with no value. instances with no value. - +## Remarks Use when a host needs to execute code in an application domain that has restricted security permissions. Use to unwrap the return value. @@ -1916,7 +1888,7 @@ An error occurred when attempting remote activation in a target specified in The type to create. Creates an instance of the type designated by the specified generic type parameter, using the parameterless constructor. - A reference to the newly created object. + A reference to the newly created object, or for instances. .NET for Win The name of a file that contains an assembly where the type named is sought. The name of the type to create an instance of. Creates an instance of the type whose name is specified, using the named assembly file and parameterless constructor. - A handle that must be unwrapped to access the newly created instance. + A handle that must be unwrapped to access the newly created object, or for instances. .NET for Win The name of a file that contains an assembly where the type named is sought. The name of the type to create an instance of. Creates an instance of the type whose name is specified in the specified remote domain, using the named assembly file and parameterless constructor. - A handle that must be unwrapped to access the newly created instance. + A handle that must be unwrapped to access the newly created object, or for instances. .NET for Win This parameter is related to client-activated objects. Client activation is a legacy technology that is retained for backward compatibility but is not recommended for new development. Distributed applications should instead use Windows Communication Foundation. Creates an instance of the type whose name is specified, using the named assembly file and parameterless constructor. - A handle that must be unwrapped to access the newly created instance. + A handle that must be unwrapped to access the newly created object, or for instances. .NET for Win This parameter is related to client-activated objects. Client activation is a legacy technology that is retained for backward compatibility but is not recommended for new development. Distributed applications should instead use Windows Communication Foundation. Creates an instance of the type whose name is specified, using the named assembly file and the constructor that best matches the specified parameters. - A handle that must be unwrapped to access the newly created instance. + A handle that must be unwrapped to access the newly created object, or for instances. .NET for Win This parameter is related to client-activated objects. Client activation is a legacy technology that is retained for backward compatibility but is not recommended for new development. Distributed applications should instead use Windows Communication Foundation. Creates an instance of the type whose name is specified in the specified remote domain, using the named assembly file and the constructor that best matches the specified parameters. - A handle that must be unwrapped to access the newly created instance. + A handle that must be unwrapped to access the newly created object, or for instances. .NET for Win This parameter is related to client-activated objects. Client activation is a legacy technology that is retained for backward compatibility but is not recommended for new development. Distributed applications should instead use Windows Communication Foundation. Information used to make security policy decisions and grant code permissions. Creates an instance of the type whose name is specified, using the named assembly file and the constructor that best matches the specified parameters. - A handle that must be unwrapped to access the newly created instance. + A handle that must be unwrapped to access the newly created object, or for instances. .NET for Win This parameter is related to client-activated objects. Client activation is a legacy technology that is retained for backward compatibility but is not recommended for new development. Distributed applications should instead use Windows Communication Foundation. Information used to make security policy decisions and grant code permissions. Creates an instance of the type whose name is specified in the specified remote domain, using the named assembly file and the constructor that best matches the specified parameters. - A handle that must be unwrapped to access the newly created instance. + A handle that must be unwrapped to access the newly created object, or for instances.