Activator.CreateInstanceFrom Метод

Определение

Создает экземпляр типа с заданным именем, используя для этого файл именованной сборки и конструктор, который наилучшим образом соответствует заданным параметрам.Creates an instance of the type whose name is specified, using the named assembly file and the constructor that best matches the specified parameters.

Перегрузки

CreateInstanceFrom(AppDomain, String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[], Evidence)

Создает экземпляр типа с заданным именем в указанном удаленном домене, используя для этого файл именованной сборки и конструктор, который наилучшим образом соответствует заданным параметрам.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.

CreateInstanceFrom(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[], Evidence)

Создает экземпляр типа с заданным именем, используя для этого файл именованной сборки и конструктор, который наилучшим образом соответствует заданным параметрам.Creates an instance of the type whose name is specified, using the named assembly file and the constructor that best matches the specified parameters.

CreateInstanceFrom(AppDomain, String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])

Создает экземпляр типа с заданным именем в указанном удаленном домене, используя для этого файл именованной сборки и конструктор, который наилучшим образом соответствует заданным параметрам.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.

CreateInstanceFrom(String, String, Object[])

Создает экземпляр типа с заданным именем, используя для этого файл именованной сборки и конструктор без параметров.Creates an instance of the type whose name is specified, using the named assembly file and parameterless constructor.

CreateInstanceFrom(AppDomain, String, String)

Создает экземпляр типа с заданным именем в указанном удаленном домене, используя для этого файл именованной сборки и конструктор без параметров.Creates an instance of the type whose name is specified in the specified remote domain, using the named assembly file and parameterless constructor.

CreateInstanceFrom(String, String)

Создает экземпляр типа с заданным именем, используя для этого файл именованной сборки и конструктор без параметров.Creates an instance of the type whose name is specified, using the named assembly file and parameterless constructor.

CreateInstanceFrom(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])

Создает экземпляр типа с заданным именем, используя для этого файл именованной сборки и конструктор, который наилучшим образом соответствует заданным параметрам.Creates an instance of the type whose name is specified, using the named assembly file and the constructor that best matches the specified parameters.

CreateInstanceFrom(AppDomain, String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[], Evidence)

Предупреждение

Этот API устарел.

Создает экземпляр типа с заданным именем в указанном удаленном домене, используя для этого файл именованной сборки и конструктор, который наилучшим образом соответствует заданным параметрам.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.

public:
 static System::Runtime::Remoting::ObjectHandle ^ CreateInstanceFrom(AppDomain ^ domain, System::String ^ assemblyFile, System::String ^ typeName, bool ignoreCase, System::Reflection::BindingFlags bindingAttr, System::Reflection::Binder ^ binder, cli::array <System::Object ^> ^ args, System::Globalization::CultureInfo ^ culture, cli::array <System::Object ^> ^ activationAttributes, System::Security::Policy::Evidence ^ securityAttributes);
[System.Obsolete("Methods which use Evidence to sandbox are obsolete and will be removed in a future release of the .NET Framework. Please use an overload of CreateInstanceFrom which does not take an Evidence parameter. See https://go.microsoft.com/fwlink/?LinkID=155570 for more information.")]
[System.Security.SecurityCritical]
public static System.Runtime.Remoting.ObjectHandle CreateInstanceFrom (AppDomain domain, string assemblyFile, string typeName, bool ignoreCase, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder binder, object[] args, System.Globalization.CultureInfo culture, object[] activationAttributes, System.Security.Policy.Evidence securityAttributes);
static member CreateInstanceFrom : AppDomain * string * string * bool * System.Reflection.BindingFlags * System.Reflection.Binder * obj[] * System.Globalization.CultureInfo * obj[] * System.Security.Policy.Evidence -> System.Runtime.Remoting.ObjectHandle

Параметры

domain
AppDomain

Удаленный домен, в котором создан тип с именем typeName.The remote domain where the type named typeName is created.

assemblyFile
String

Имя файла, содержащего сборку, в которой выполняется поиск типа, заданного параметром typeName.The name of a file that contains an assembly where the type named typeName is sought.

typeName
String

Имя предпочтительного типа.The name of the preferred type.

ignoreCase
Boolean

Значение true для выполнения поиска typeName без учета регистра; значение false для выполнения поиска с учетом регистра.true to specify that the search for typeName is not case-sensitive; false to specify that the search is case-sensitive.

bindingAttr
BindingFlags

Сочетание битовых флагов (от нуля и более), влияющих на поиск конструктора typeName.A combination of zero or more bit flags that affect the search for the typeName constructor. Если значение параметра bindingAttr равно нулю, проводится поиск открытых конструкторов с учетом регистра.If bindingAttr is zero, a case-sensitive search for public constructors is conducted.

binder
Binder

Объект, который использует параметры bindingAttr и args для поиска и идентификации конструктора typeName.An object that uses bindingAttr and args to seek and identify the typeName constructor. Если значение параметра binder равно null, используется связыватель по умолчанию.If binder is null, the default binder is used.

args
Object[]

Массив аргументов, число, порядок и тип которых соответствуют параметрам вызываемого конструктора.An array of arguments that match in number, order, and type the parameters of the constructor to invoke. Если параметр args предоставляет пустой массив или имеет значение null, то вызывается конструктор, который не принимает никаких параметров (конструктор без параметров).If args is an empty array or null, the constructor that takes no parameters (the parameterless constructor) is invoked.

culture
CultureInfo

Сведения о языке и региональных параметрах, которые влияют на приведение args к формальным типам, объявленным для конструктора typeName.Culture-specific information that governs the coercion of args to the formal types declared for the typeName constructor. Если параметр culture имеет значение null, для текущего потока используется объект CultureInfo.If culture is null, the CultureInfo for the current thread is used.

activationAttributes
Object[]

Массив, состоящий из одного или нескольких атрибутов, которые могут участвовать в активации.An array of one or more attributes that can participate in activation. Как правило, это массив, содержащий один объект UrlAttribute, определяющий URL-адрес, необходимый для активации удаленного объекта.This is typically an array that contains a single UrlAttribute object that specifies the URL that is required to activate a remote object.

Этот параметр связан с объектами, активируемыми клиентом.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. Сейчас в распределенных приложениях следует использовать Windows Communication Foundation.Distributed applications should instead use Windows Communication Foundation.

securityAttributes
Evidence

Сведения, используемые для принятия решений согласно политике безопасности и предоставления разрешений для кода.Information used to make security policy decisions and grant code permissions.

Возвраты

Дескриптор, оболочку которого нужно удалить, чтобы получить доступ к вновь созданному экземпляру.A handle that must be unwrapped to access the newly created instance.

Атрибуты

Исключения

Значение параметра domain или typeNamenull.domain or typeName is null.

Соответствующий конструктор не найден.No matching constructor was found.

Не удалось найти typename в assemblyFile.typename was not found in assemblyFile.

Не удалось найти assemblyFile.assemblyFile was not found.

Вызывающий объект не имеет разрешения на вызов этого конструктора.The caller does not have permission to call this constructor.

Невозможно создать экземпляр абстрактного класса, или этот элемент был вызван с помощь механизма позднего связывания.Cannot create an instance of an abstract class, or this member was invoked with a late-binding mechanism.

Конструктор, который был вызван с помощью отражения, создал исключение.The constructor, which was invoked through reflection, threw an exception.

У вызывающего оператора нет необходимого разрешения FileIOPermission.The caller does have the required FileIOPermission.

activationAttributes не является пустым массивом, а создаваемый тип не является производным от MarshalByRefObject.activationAttributes is not an empty array, and the type being created does not derive from MarshalByRefObject.

assemblyFile не является допустимой сборкой.assemblyFile is not a valid assembly.

- или --or- В данный момент загружена среда CLR версии 2.0 или более поздней. Объект assemblyName был скомпилирован для версии среды CLR, более поздней, чем загруженная.The common language runtime (CLR) version 2.0 or later is currently loaded, and assemblyName was compiled for a version of the CLR that is later than the currently loaded version. Обратите внимание, что .NET Framework версий 2.0, 3.0 и 3.5 использует среду CLR версии 2.0.Note that the .NET Framework versions 2.0, 3.0, and 3.5 all use CLR version 2.0.

Комментарии

Используйте CreateInstanceFrom, когда узлу требуется выполнить код в домене приложения с ограниченными разрешениями безопасности.Use CreateInstanceFrom when a host needs to execute code in an application domain that has restricted security permissions.

Для распаковки возвращаемого значения используйте метод ObjectHandle.Unwrap.Use the ObjectHandle.Unwrap method to unwrap the return value.

Примечание

Этот метод использует SecurityAction.LinkDemand, чтобы непосредственный вызывающий объект имел полное доверие.This method uses SecurityAction.LinkDemand to require the immediate caller to have full trust.

Сведения о других исключениях, которые могут вызываться вызванными методами, см. в разделе "исключения" в методах Assembly.LoadFrom и CreateInstance.For information about other exceptions that can be thrown by invoked methods, see the Exceptions section of the Assembly.LoadFrom and CreateInstance methods.

Безопасность

SecurityPermission
для предоставления свидетельства.for supplying evidence. Связанное перечисление: ControlEvidenceAssociated enumeration: ControlEvidence

FileIOPermission
возможность поиска путей к каталогам и считывания их содержимого.for the ability to search directory paths and read their contents. Связанные перечисления: PathDiscovery и ReadAssociated enumerations: PathDiscovery and Read

ReflectionPermission
для доступа к закрытым типам и членам независимо от набора их разрешений.for accessing nonpublic types and members regardless of their grant set. Связанное перечисление: MemberAccessAssociated enumeration: MemberAccess

SecurityCriticalAttribute
Требуется полное доверие для немедленного вызывающего объекта.requires full trust for the immediate caller. Этот член не может использоваться частично доверенным или прозрачным кодом.This member cannot be used by partially trusted or transparent code.

CreateInstanceFrom(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[], Evidence)

Предупреждение

Этот API устарел.

Создает экземпляр типа с заданным именем, используя для этого файл именованной сборки и конструктор, который наилучшим образом соответствует заданным параметрам.Creates an instance of the type whose name is specified, using the named assembly file and the constructor that best matches the specified parameters.

public:
 static System::Runtime::Remoting::ObjectHandle ^ CreateInstanceFrom(System::String ^ assemblyFile, System::String ^ typeName, bool ignoreCase, System::Reflection::BindingFlags bindingAttr, System::Reflection::Binder ^ binder, cli::array <System::Object ^> ^ args, System::Globalization::CultureInfo ^ culture, cli::array <System::Object ^> ^ activationAttributes, System::Security::Policy::Evidence ^ securityInfo);
[System.Obsolete("Methods which use evidence to sandbox are obsolete and will be removed in a future release of the .NET Framework. Please use an overload of CreateInstanceFrom which does not take an Evidence parameter. See https://go.microsoft.com/fwlink/?LinkID=155570 for more information.")]
public static System.Runtime.Remoting.ObjectHandle CreateInstanceFrom (string assemblyFile, string typeName, bool ignoreCase, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder binder, object[] args, System.Globalization.CultureInfo culture, object[] activationAttributes, System.Security.Policy.Evidence securityInfo);
static member CreateInstanceFrom : string * string * bool * System.Reflection.BindingFlags * System.Reflection.Binder * obj[] * System.Globalization.CultureInfo * obj[] * System.Security.Policy.Evidence -> System.Runtime.Remoting.ObjectHandle

Параметры

assemblyFile
String

Имя файла, содержащего сборку, в которой выполняется поиск типа, заданного параметром typeName.The name of a file that contains an assembly where the type named typeName is sought.

typeName
String

Имя предпочтительного типа.The name of the preferred type.

ignoreCase
Boolean

Значение true для выполнения поиска typeName без учета регистра; значение false для выполнения поиска с учетом регистра.true to specify that the search for typeName is not case-sensitive; false to specify that the search is case-sensitive.

bindingAttr
BindingFlags

Сочетание битовых флагов (от нуля и более), влияющих на поиск конструктора typeName.A combination of zero or more bit flags that affect the search for the typeName constructor. Если значение параметра bindingAttr равно нулю, проводится поиск открытых конструкторов с учетом регистра.If bindingAttr is zero, a case-sensitive search for public constructors is conducted.

binder
Binder

Объект, который использует параметры bindingAttr и args для поиска и идентификации конструктора typeName.An object that uses bindingAttr and args to seek and identify the typeName constructor. Если значение параметра binder равно null, используется связыватель по умолчанию.If binder is null, the default binder is used.

args
Object[]

Массив аргументов, число, порядок и тип которых соответствуют параметрам вызываемого конструктора.An array of arguments that match in number, order, and type the parameters of the constructor to invoke. Если параметр args предоставляет пустой массив или имеет значение null, то вызывается конструктор, который не принимает никаких параметров (конструктор без параметров).If args is an empty array or null, the constructor that takes no parameters (the parameterless constructor) is invoked.

culture
CultureInfo

Сведения о языке и региональных параметрах, которые влияют на приведение args к формальным типам, объявленным для конструктора typeName.Culture-specific information that governs the coercion of args to the formal types declared for the typeName constructor. Если параметр culture имеет значение null, для текущего потока используется объект CultureInfo.If culture is null, the CultureInfo for the current thread is used.

activationAttributes
Object[]

Массив, состоящий из одного или нескольких атрибутов, которые могут участвовать в активации.An array of one or more attributes that can participate in activation. Как правило, это массив, содержащий один объект UrlAttribute, определяющий URL-адрес, необходимый для активации удаленного объекта.This is typically an array that contains a single UrlAttribute object that specifies the URL that is required to activate a remote object.

Этот параметр связан с объектами, активируемыми клиентом.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. Сейчас в распределенных приложениях следует использовать Windows Communication Foundation.Distributed applications should instead use Windows Communication Foundation.

securityInfo
Evidence

Сведения, используемые для принятия решений согласно политике безопасности и предоставления разрешений для кода.Information used to make security policy decisions and grant code permissions.

Возвраты

Дескриптор, оболочку которого нужно удалить, чтобы получить доступ к вновь созданному экземпляру.A handle that must be unwrapped to access the newly created instance.

Атрибуты

Исключения

Свойство typeName имеет значение null.typeName is null.

Соответствующий конструктор не найден.No matching constructor was found.

Не удалось найти typename в assemblyFile.typename was not found in assemblyFile.

Не удалось найти assemblyFile.assemblyFile was not found.

Вызывающий объект не имеет разрешения на вызов этого конструктора.The caller does not have permission to call this constructor.

Невозможно создать экземпляр абстрактного класса, или этот элемент был вызван с помощь механизма позднего связывания.Cannot create an instance of an abstract class, or this member was invoked with a late-binding mechanism.

Конструктор, который был вызван с помощью отражения, создал исключение.The constructor, which was invoked through reflection, threw an exception.

Вызывающий оператор не имеет необходимого разрешения FileIOPermission.The caller does not have the required FileIOPermission.

activationAttributes не является пустым массивом, а создаваемый тип не является производным от MarshalByRefObject.activationAttributes is not an empty array, and the type being created does not derive from MarshalByRefObject.

assemblyFile не является допустимой сборкой.assemblyFile is not a valid assembly.

- или --or- В данный момент загружена среда CLR версии 2.0 или более поздней. Объект assemblyName был скомпилирован для версии среды CLR, более поздней, чем загруженная.The common language runtime (CLR) version 2.0 or later is currently loaded, and assemblyName was compiled for a version of the CLR that is later than the currently loaded version. Обратите внимание, что .NET Framework версий 2.0, 3.0 и 3.5 использует среду CLR версии 2.0.Note that the .NET Framework versions 2.0, 3.0, and 3.5 all use CLR version 2.0.

Комментарии

Для распаковки возвращаемого значения используйте метод ObjectHandle.Unwrap.Use the ObjectHandle.Unwrap method to unwrap the return value.

Сведения о других исключениях, которые могут вызываться вызванными методами, см. в разделе "исключения" в методах Assembly.LoadFrom и CreateInstance.For information about other exceptions that can be thrown by invoked methods, see the Exceptions section of the Assembly.LoadFrom and CreateInstance methods.

Безопасность

SecurityPermission
для возможности вызова неуправляемого кода при создании экземпляра делегата.for the ability to call unmanaged code when creating an instance of a delegate. Связанное перечисление: UnmanagedCodeAssociated enumeration: UnmanagedCode

FileIOPermission
возможность поиска путей к каталогам и считывания их содержимого.for the ability to search directory paths and read their contents. Связанные перечисления: PathDiscovery и ReadAssociated enumerations: PathDiscovery and Read

ReflectionPermission
для доступа к закрытым типам и членам независимо от набора их разрешений.for accessing nonpublic types and members regardless of their grant set. Связанное перечисление: MemberAccessAssociated enumeration: MemberAccess

CreateInstanceFrom(AppDomain, String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])

Создает экземпляр типа с заданным именем в указанном удаленном домене, используя для этого файл именованной сборки и конструктор, который наилучшим образом соответствует заданным параметрам.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.

public:
 static System::Runtime::Remoting::ObjectHandle ^ CreateInstanceFrom(AppDomain ^ domain, System::String ^ assemblyFile, System::String ^ typeName, bool ignoreCase, System::Reflection::BindingFlags bindingAttr, System::Reflection::Binder ^ binder, cli::array <System::Object ^> ^ args, System::Globalization::CultureInfo ^ culture, cli::array <System::Object ^> ^ activationAttributes);
[System.Security.SecurityCritical]
public static System.Runtime.Remoting.ObjectHandle CreateInstanceFrom (AppDomain domain, string assemblyFile, string typeName, bool ignoreCase, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder binder, object[] args, System.Globalization.CultureInfo culture, object[] activationAttributes);
static member CreateInstanceFrom : AppDomain * string * string * bool * System.Reflection.BindingFlags * System.Reflection.Binder * obj[] * System.Globalization.CultureInfo * obj[] -> System.Runtime.Remoting.ObjectHandle

Параметры

domain
AppDomain

Удаленный домен, в котором создан тип с именем typeName.The remote domain where the type named typeName is created.

assemblyFile
String

Имя файла, содержащего сборку, в которой выполняется поиск типа, заданного параметром typeName.The name of a file that contains an assembly where the type named typeName is sought.

typeName
String

Имя предпочтительного типа.The name of the preferred type.

ignoreCase
Boolean

Значение true для выполнения поиска typeName без учета регистра; значение false для выполнения поиска с учетом регистра.true to specify that the search for typeName is not case-sensitive; false to specify that the search is case-sensitive.

bindingAttr
BindingFlags

Сочетание битовых флагов (от нуля и более), влияющих на поиск конструктора typeName.A combination of zero or more bit flags that affect the search for the typeName constructor. Если значение параметра bindingAttr равно нулю, проводится поиск открытых конструкторов с учетом регистра.If bindingAttr is zero, a case-sensitive search for public constructors is conducted.

binder
Binder

Объект, который использует параметры bindingAttr и args для поиска и идентификации конструктора typeName.An object that uses bindingAttr and args to seek and identify the typeName constructor. Если значение параметра binder равно null, используется связыватель по умолчанию.If binder is null, the default binder is used.

args
Object[]

Массив аргументов, число, порядок и тип которых соответствуют параметрам вызываемого конструктора.An array of arguments that match in number, order, and type the parameters of the constructor to invoke. Если параметр args предоставляет пустой массив или имеет значение null, то вызывается конструктор, который не принимает никаких параметров (конструктор без параметров).If args is an empty array or null, the constructor that takes no parameters (the parameterless constructor) is invoked.

culture
CultureInfo

Сведения о языке и региональных параметрах, которые влияют на приведение args к формальным типам, объявленным для конструктора typeName.Culture-specific information that governs the coercion of args to the formal types declared for the typeName constructor. Если параметр culture имеет значение null, для текущего потока используется объект CultureInfo.If culture is null, the CultureInfo for the current thread is used.

activationAttributes
Object[]

Массив, состоящий из одного или нескольких атрибутов, которые могут участвовать в активации.An array of one or more attributes that can participate in activation. Как правило, это массив, содержащий один объект UrlAttribute, определяющий URL-адрес, необходимый для активации удаленного объекта.This is typically an array that contains a single UrlAttribute object that specifies the URL that is required to activate a remote object.

Этот параметр связан с объектами, активируемыми клиентом.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. Сейчас в распределенных приложениях следует использовать Windows Communication Foundation.Distributed applications should instead use Windows Communication Foundation.

Возвраты

Дескриптор, оболочку которого нужно удалить, чтобы получить доступ к вновь созданному экземпляру.A handle that must be unwrapped to access the newly created instance.

Атрибуты

Исключения

Значение параметра domain или typeNamenull.domain or typeName is null.

Соответствующий конструктор не найден.No matching constructor was found.

Не удалось найти typename в assemblyFile.typename was not found in assemblyFile.

Не удалось найти assemblyFile.assemblyFile was not found.

Вызывающий объект не имеет разрешения на вызов этого конструктора.The caller does not have permission to call this constructor.

Невозможно создать экземпляр абстрактного класса, или этот элемент был вызван с помощь механизма позднего связывания.Cannot create an instance of an abstract class, or this member was invoked with a late-binding mechanism.

Конструктор, который был вызван с помощью отражения, создал исключение.The constructor, which was invoked through reflection, threw an exception.

У вызывающего оператора нет необходимого разрешения FileIOPermission.The caller does have the required FileIOPermission.

activationAttributes не является пустым массивом, а создаваемый тип не является производным от MarshalByRefObject.activationAttributes is not an empty array, and the type being created does not derive from MarshalByRefObject.

assemblyFile не является допустимой сборкой.assemblyFile is not a valid assembly.

- или --or- assemblyName был скомпилирован для версии общеязыковой среды выполнения, которая является более поздней, чем версия, которая в настоящий момент загружена.assemblyName was compiled for a version of the common language runtime that is later than the version that is currently loaded.

Комментарии

Используйте CreateInstanceFrom, когда узлу требуется выполнить код в домене приложения с ограниченными разрешениями безопасности.Use CreateInstanceFrom when a host needs to execute code in an application domain that has restricted security permissions.

Для распаковки возвращаемого значения используйте метод ObjectHandle.Unwrap.Use the ObjectHandle.Unwrap method to unwrap the return value.

Сведения о других исключениях, которые могут вызываться вызванными методами, см. в разделах "исключения" в методах Assembly.LoadFrom и CreateInstance.For information about other exceptions that can be thrown by invoked methods, see the Exceptions sections of the Assembly.LoadFrom and CreateInstance methods.

Безопасность

SecurityPermission
для предоставления свидетельства.for supplying evidence. Связанное перечисление: ControlEvidenceAssociated enumeration: ControlEvidence

FileIOPermission
возможность поиска путей к каталогам и считывания их содержимого.for the ability to search directory paths and read their contents. Связанные перечисления: PathDiscovery и ReadAssociated enumerations: PathDiscovery and Read

ReflectionPermission
для доступа к закрытым типам и членам независимо от набора их разрешений.for accessing nonpublic types and members regardless of their grant set. Связанное перечисление: MemberAccessAssociated enumeration: MemberAccess

SecurityCriticalAttribute
Требуется полное доверие для немедленного вызывающего объекта.requires full trust for the immediate caller. Этот член не может использоваться частично доверенным или прозрачным кодом.This member cannot be used by partially trusted or transparent code.

CreateInstanceFrom(String, String, Object[])

Создает экземпляр типа с заданным именем, используя для этого файл именованной сборки и конструктор без параметров.Creates an instance of the type whose name is specified, using the named assembly file and parameterless constructor.

public:
 static System::Runtime::Remoting::ObjectHandle ^ CreateInstanceFrom(System::String ^ assemblyFile, System::String ^ typeName, cli::array <System::Object ^> ^ activationAttributes);
public static System.Runtime.Remoting.ObjectHandle CreateInstanceFrom (string assemblyFile, string typeName, object[] activationAttributes);
static member CreateInstanceFrom : string * string * obj[] -> System.Runtime.Remoting.ObjectHandle
Public Shared Function CreateInstanceFrom (assemblyFile As String, typeName As String, activationAttributes As Object()) As ObjectHandle

Параметры

assemblyFile
String

Имя файла, содержащего сборку, в которой выполняется поиск типа, заданного параметром typeName.The name of a file that contains an assembly where the type named typeName is sought.

typeName
String

Имя предпочтительного типа.The name of the preferred type.

activationAttributes
Object[]

Массив, состоящий из одного или нескольких атрибутов, которые могут участвовать в активации.An array of one or more attributes that can participate in activation. Как правило, это массив, содержащий один объект UrlAttribute, определяющий URL-адрес, необходимый для активации удаленного объекта.This is typically an array that contains a single UrlAttribute object that specifies the URL that is required to activate a remote object.

Этот параметр связан с объектами, активируемыми клиентом.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. Сейчас в распределенных приложениях следует использовать Windows Communication Foundation.Distributed applications should instead use Windows Communication Foundation.

Возвраты

Дескриптор, оболочку которого нужно удалить, чтобы получить доступ к вновь созданному экземпляру.A handle that must be unwrapped to access the newly created instance.

Исключения

typeNamenull.typeName is null.

Соответствующий общий конструктор не найден.No matching public constructor was found.

Не удалось найти typename в assemblyFile.typename was not found in assemblyFile.

Не удалось найти assemblyFile.assemblyFile was not found.

Вызывающий объект не имеет разрешения на вызов этого конструктора.The caller does not have permission to call this constructor.

Невозможно создать экземпляр абстрактного класса, или этот элемент был вызван с помощь механизма позднего связывания.Cannot create an instance of an abstract class, or this member was invoked with a late-binding mechanism.

Конструктор, который был вызван с помощью отражения, создал исключение.The constructor, which was invoked through reflection, threw an exception.

activationAttributes не является пустым массивом, а создаваемый тип не является производным от MarshalByRefObject.activationAttributes is not an empty array, and the type being created does not derive from MarshalByRefObject.

У вызывающего оператора нет необходимого разрешения FileIOPermission.The caller does have the required FileIOPermission.

assemblyFile не является допустимой сборкой.assemblyFile is not a valid assembly.

- или --or- В данный момент загружена среда CLR версии 2.0 или более поздней. Объект assemblyName был скомпилирован для версии среды CLR, более поздней, чем загруженная.The common language runtime (CLR) version 2.0 or later is currently loaded, and assemblyName was compiled for a version of the CLR that is later than the currently loaded version. Обратите внимание, что .NET Framework версий 2.0, 3.0 и 3.5 использует среду CLR версии 2.0.Note that the .NET Framework versions 2.0, 3.0, and 3.5 all use CLR version 2.0.

Комментарии

Для распаковки возвращаемого значения используйте метод ObjectHandle.Unwrap.Use the ObjectHandle.Unwrap method to unwrap the return value.

Сведения о других исключениях, которые могут вызываться вызванными методами, см. в разделе "исключения" в методах Assembly.LoadFrom и CreateInstance.For information about other exceptions that can be thrown by invoked methods, see the Exceptions section of the Assembly.LoadFrom and CreateInstance methods.

Безопасность

SecurityPermission
для возможности вызова неуправляемого кода при создании экземпляра делегата.for the ability to call unmanaged code when creating an instance of a delegate. Связанное перечисление: UnmanagedCodeAssociated enumeration: UnmanagedCode

FileIOPermission
возможность поиска путей к каталогам и считывания их содержимого.for the ability to search directory paths and read their contents. Связанные перечисления: PathDiscovery и ReadAssociated enumerations: PathDiscovery and Read

ReflectionPermission
для доступа к закрытым типам независимо от набора их разрешений.for accessing nonpublic types regardless of their grant set. Связанное перечисление: MemberAccessAssociated enumeration: MemberAccess

CreateInstanceFrom(AppDomain, String, String)

Создает экземпляр типа с заданным именем в указанном удаленном домене, используя для этого файл именованной сборки и конструктор без параметров.Creates an instance of the type whose name is specified in the specified remote domain, using the named assembly file and parameterless constructor.

public:
 static System::Runtime::Remoting::ObjectHandle ^ CreateInstanceFrom(AppDomain ^ domain, System::String ^ assemblyFile, System::String ^ typeName);
[System.Security.SecurityCritical]
public static System.Runtime.Remoting.ObjectHandle CreateInstanceFrom (AppDomain domain, string assemblyFile, string typeName);
static member CreateInstanceFrom : AppDomain * string * string -> System.Runtime.Remoting.ObjectHandle
Public Shared Function CreateInstanceFrom (domain As AppDomain, assemblyFile As String, typeName As String) As ObjectHandle

Параметры

domain
AppDomain

Удаленный домен, в котором создан тип с именем typeName.The remote domain where the type named typeName is created.

assemblyFile
String

Имя файла, содержащего сборку, в которой выполняется поиск типа, заданного параметром typeName.The name of a file that contains an assembly where the type named typeName is sought.

typeName
String

Имя предпочтительного типа.The name of the preferred type.

Возвраты

Дескриптор, оболочку которого нужно удалить, чтобы получить доступ к вновь созданному экземпляру.A handle that must be unwrapped to access the newly created instance.

Атрибуты

Исключения

Значение параметра domain или typeNamenull.domain or typeName is null.

Соответствующий общий конструктор не найден.No matching public constructor was found.

Не удалось найти typename в assemblyFile.typename was not found in assemblyFile.

Не удалось найти assemblyFile.assemblyFile was not found.

Вызывающий объект не имеет разрешения на вызов этого конструктора.The caller does not have permission to call this constructor.

Невозможно создать экземпляр абстрактного класса, или этот элемент был вызван с помощь механизма позднего связывания.Cannot create an instance of an abstract class, or this member was invoked with a late-binding mechanism.

Конструктор, который был вызван с помощью отражения, создал исключение.The constructor, which was invoked through reflection, threw an exception.

У вызывающего оператора нет необходимого разрешения FileIOPermission.The caller does have the required FileIOPermission.

assemblyFile не является допустимой сборкой.assemblyFile is not a valid assembly.

- или --or- В данный момент загружена среда CLR версии 2.0 или более поздней. Объект assemblyName был скомпилирован для версии среды CLR, более поздней, чем загруженная.The common language runtime (CLR) version 2.0 or later is currently loaded, and assemblyName was compiled for a version of the CLR that is later than the currently loaded version. Обратите внимание, что .NET Framework версий 2.0, 3.0 и 3.5 использует среду CLR версии 2.0.Note that the .NET Framework versions 2.0, 3.0, and 3.5 all use CLR version 2.0.

Комментарии

Используйте CreateInstanceFrom, когда узлу требуется выполнить код в домене приложения с ограниченными разрешениями безопасности.Use CreateInstanceFrom when a host needs to execute code in an application domain that has restricted security permissions.

Для распаковки возвращаемого значения используйте метод ObjectHandle.Unwrap.Use the ObjectHandle.Unwrap method to unwrap the return value.

Примечание

Этот метод использует SecurityAction.LinkDemand, чтобы непосредственный вызывающий объект имел полное доверие.This method uses SecurityAction.LinkDemand to require the immediate caller to have full trust.

Сведения о других исключениях, которые могут вызываться вызванными методами, см. в разделе "исключения" в методах Assembly.LoadFrom и CreateInstance.For information about other exceptions that can be thrown by invoked methods, see the Exceptions section of the Assembly.LoadFrom and CreateInstance methods.

Безопасность

SecurityPermission
для возможности вызова неуправляемого кода при создании экземпляра делегата.for the ability to call unmanaged code when creating an instance of a delegate. Связанное перечисление: UnmanagedCodeAssociated enumeration: UnmanagedCode

FileIOPermission
возможность поиска путей к каталогам и считывания их содержимого.for the ability to search directory paths and read their contents. Связанные перечисления: PathDiscovery и ReadAssociated enumerations: PathDiscovery and Read

SecurityCriticalAttribute
Требуется полное доверие для немедленного вызывающего объекта.requires full trust for the immediate caller. Этот член не может использоваться частично доверенным или прозрачным кодом.This member cannot be used by partially trusted or transparent code.

CreateInstanceFrom(String, String)

Создает экземпляр типа с заданным именем, используя для этого файл именованной сборки и конструктор без параметров.Creates an instance of the type whose name is specified, using the named assembly file and parameterless constructor.

public:
 static System::Runtime::Remoting::ObjectHandle ^ CreateInstanceFrom(System::String ^ assemblyFile, System::String ^ typeName);
public static System.Runtime.Remoting.ObjectHandle CreateInstanceFrom (string assemblyFile, string typeName);
static member CreateInstanceFrom : string * string -> System.Runtime.Remoting.ObjectHandle
Public Shared Function CreateInstanceFrom (assemblyFile As String, typeName As String) As ObjectHandle

Параметры

assemblyFile
String

Имя файла, содержащего сборку, в которой выполняется поиск типа, заданного параметром typeName.The name of a file that contains an assembly where the type named typeName is sought.

typeName
String

Имя предпочтительного типа.The name of the preferred type.

Возвраты

Дескриптор, оболочку которого нужно удалить, чтобы получить доступ к вновь созданному экземпляру.A handle that must be unwrapped to access the newly created instance.

Исключения

Свойство typeName имеет значение null.typeName is null.

Соответствующий общий конструктор не найден.No matching public constructor was found.

Не удалось найти typename в assemblyFile.typename was not found in assemblyFile.

Не удалось найти assemblyFile.assemblyFile was not found.

Вызывающий объект не имеет разрешения на вызов этого конструктора.The caller does not have permission to call this constructor.

Невозможно создать экземпляр абстрактного класса, или этот элемент был вызван с помощь механизма позднего связывания.Cannot create an instance of an abstract class, or this member was invoked with a late-binding mechanism.

Конструктор, который был вызван с помощью отражения, создал исключение.The constructor, which was invoked through reflection, threw an exception.

У вызывающего оператора нет необходимого разрешения FileIOPermission.The caller does have the required FileIOPermission.

assemblyFile не является допустимой сборкой.assemblyFile is not a valid assembly.

- или --or- В данный момент загружена среда CLR версии 2.0 или более поздней. Объект assemblyName был скомпилирован для версии среды CLR, более поздней, чем загруженная.The common language runtime (CLR) version 2.0 or later is currently loaded, and assemblyName was compiled for a version of the CLR that is later than the currently loaded version. Обратите внимание, что .NET Framework версий 2.0, 3.0 и 3.5 использует среду CLR версии 2.0.Note that the .NET Framework versions 2.0, 3.0, and 3.5 all use CLR version 2.0.

Примеры

В следующем примере кода показано, как вызвать метод CreateInstanceFrom.The following code example demonstrates how to call the CreateInstanceFrom method. Этот пример кода является частью большого примера, приведенного для класса Activator.This code example is part of a larger example provided for the Activator class.

// Create an instance of the SomeType class that is defined in this 
// assembly.
System::Runtime::Remoting::ObjectHandle^ oh = 
    Activator::CreateInstanceFrom(Assembly::GetEntryAssembly()->CodeBase, 
                                  SomeType::typeid->FullName);

// Call an instance method defined by the SomeType type using this object.
SomeType^ st = (SomeType^) oh->Unwrap();

st->DoSomething(5);
// Create an instance of the SomeType class that is defined in this 
// assembly.
System.Runtime.Remoting.ObjectHandle oh = 
    Activator.CreateInstanceFrom(Assembly.GetEntryAssembly().CodeBase, 
                                 typeof(SomeType).FullName);

// Call an instance method defined by the SomeType type using this object.
SomeType st = (SomeType) oh.Unwrap();

st.DoSomething(5);
' Create an instance of the SomeType class that is defined in this assembly.
Dim oh As System.Runtime.Remoting.ObjectHandle = _
    Activator.CreateInstanceFrom(Assembly.GetEntryAssembly().CodeBase, _
                                 GetType(SomeType).FullName)

' Call an instance method defined by the SomeType type using this object.
Dim st As SomeType = CType(oh.Unwrap(), SomeType)

st.DoSomething(5)

Комментарии

Для распаковки возвращаемого значения используйте метод ObjectHandle.Unwrap.Use the ObjectHandle.Unwrap method to unwrap the return value.

Сведения о других исключениях, которые могут вызываться вызванными методами, см. в разделе "исключения" в методах Assembly.LoadFrom и CreateInstance.For information about other exceptions that can be thrown by invoked methods, see the Exceptions section of the Assembly.LoadFrom and CreateInstance methods.

Безопасность

SecurityPermission
для возможности вызова неуправляемого кода при создании экземпляра делегата.for the ability to call unmanaged code when creating an instance of a delegate. Связанное перечисление: UnmanagedCodeAssociated enumeration: UnmanagedCode

FileIOPermission
возможность поиска путей к каталогам и считывания их содержимого.for the ability to search directory paths and read their contents. Связанные перечисления: PathDiscovery и ReadAssociated enumerations: PathDiscovery and Read

ReflectionPermission
для доступа к закрытым типам независимо от набора их разрешений.for accessing nonpublic types regardless of their grant set. Связанное перечисление: MemberAccessAssociated enumeration: MemberAccess

CreateInstanceFrom(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])

Создает экземпляр типа с заданным именем, используя для этого файл именованной сборки и конструктор, который наилучшим образом соответствует заданным параметрам.Creates an instance of the type whose name is specified, using the named assembly file and the constructor that best matches the specified parameters.

public:
 static System::Runtime::Remoting::ObjectHandle ^ CreateInstanceFrom(System::String ^ assemblyFile, System::String ^ typeName, bool ignoreCase, System::Reflection::BindingFlags bindingAttr, System::Reflection::Binder ^ binder, cli::array <System::Object ^> ^ args, System::Globalization::CultureInfo ^ culture, cli::array <System::Object ^> ^ activationAttributes);
public static System.Runtime.Remoting.ObjectHandle CreateInstanceFrom (string assemblyFile, string typeName, bool ignoreCase, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder binder, object[] args, System.Globalization.CultureInfo culture, object[] activationAttributes);
static member CreateInstanceFrom : string * string * bool * System.Reflection.BindingFlags * System.Reflection.Binder * obj[] * System.Globalization.CultureInfo * obj[] -> System.Runtime.Remoting.ObjectHandle

Параметры

assemblyFile
String

Имя файла, содержащего сборку, в которой выполняется поиск типа, заданного параметром typeName.The name of a file that contains an assembly where the type named typeName is sought.

typeName
String

Имя предпочтительного типа.The name of the preferred type.

ignoreCase
Boolean

Значение true для выполнения поиска typeName без учета регистра; значение false для выполнения поиска с учетом регистра.true to specify that the search for typeName is not case-sensitive; false to specify that the search is case-sensitive.

bindingAttr
BindingFlags

Сочетание битовых флагов (от нуля и более), влияющих на поиск конструктора typeName.A combination of zero or more bit flags that affect the search for the typeName constructor. Если значение параметра bindingAttr равно нулю, проводится поиск открытых конструкторов с учетом регистра.If bindingAttr is zero, a case-sensitive search for public constructors is conducted.

binder
Binder

Объект, который использует параметры bindingAttr и args для поиска и идентификации конструктора typeName.An object that uses bindingAttr and args to seek and identify the typeName constructor. Если значение параметра binder равно null, используется связыватель по умолчанию.If binder is null, the default binder is used.

args
Object[]

Массив аргументов, число, порядок и тип которых соответствуют параметрам вызываемого конструктора.An array of arguments that match in number, order, and type the parameters of the constructor to invoke. Если параметр args предоставляет пустой массив или имеет значение null, то вызывается конструктор, который не принимает никаких параметров (конструктор без параметров).If args is an empty array or null, the constructor that takes no parameters (the parameterless constructor) is invoked.

culture
CultureInfo

Сведения о языке и региональных параметрах, которые влияют на приведение args к формальным типам, объявленным для конструктора typeName.Culture-specific information that governs the coercion of args to the formal types declared for the typeName constructor. Если параметр culture имеет значение null, для текущего потока используется объект CultureInfo.If culture is null, the CultureInfo for the current thread is used.

activationAttributes
Object[]

Массив, состоящий из одного или нескольких атрибутов, которые могут участвовать в активации.An array of one or more attributes that can participate in activation. Как правило, это массив, содержащий один объект UrlAttribute, определяющий URL-адрес, необходимый для активации удаленного объекта.This is typically an array that contains a single UrlAttribute object that specifies the URL that is required to activate a remote object.

Этот параметр связан с объектами, активируемыми клиентом.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. Сейчас в распределенных приложениях следует использовать Windows Communication Foundation.Distributed applications should instead use Windows Communication Foundation.

Возвраты

Дескриптор, оболочку которого нужно удалить, чтобы получить доступ к вновь созданному экземпляру.A handle that must be unwrapped to access the newly created instance.

Исключения

Свойство typeName имеет значение null.typeName is null.

Соответствующий конструктор не найден.No matching constructor was found.

Не удалось найти typename в assemblyFile.typename was not found in assemblyFile.

Не удалось найти assemblyFile.assemblyFile was not found.

Вызывающий объект не имеет разрешения на вызов этого конструктора.The caller does not have permission to call this constructor.

Невозможно создать экземпляр абстрактного класса, или этот элемент был вызван с помощь механизма позднего связывания.Cannot create an instance of an abstract class, or this member was invoked with a late-binding mechanism.

Конструктор, который был вызван с помощью отражения, создал исключение.The constructor, which was invoked through reflection, threw an exception.

Вызывающий оператор не имеет необходимого разрешения FileIOPermission.The caller does not have the required FileIOPermission.

activationAttributes не является пустым массивом, а создаваемый тип не является производным от MarshalByRefObject.activationAttributes is not an empty array, and the type being created does not derive from MarshalByRefObject.

assemblyFile не является допустимой сборкой.assemblyFile is not a valid assembly.

- или --or- В данный момент загружена среда CLR версии 2.0 или более поздней. Объект assemblyName был скомпилирован для версии среды CLR, более поздней, чем загруженная.The common language runtime (CLR) version 2.0 or later is currently loaded, and assemblyName was compiled for a version of the CLR that is later than the currently loaded version. Обратите внимание, что .NET Framework версий 2.0, 3.0 и 3.5 использует среду CLR версии 2.0.Note that the .NET Framework versions 2.0, 3.0, and 3.5 all use CLR version 2.0.

Комментарии

Для распаковки возвращаемого значения используйте метод ObjectHandle.Unwrap.Use the ObjectHandle.Unwrap method to unwrap the return value.

Сведения о других исключениях, которые могут вызываться вызванными методами, см. в разделе "исключения" в методах Assembly.LoadFrom и CreateInstance.For information about other exceptions that can be thrown by invoked methods, see the Exceptions section of the Assembly.LoadFrom and CreateInstance methods.

Безопасность

SecurityPermission
для возможности вызова неуправляемого кода при создании экземпляра делегата.for the ability to call unmanaged code when creating an instance of a delegate. Связанное перечисление: UnmanagedCodeAssociated enumeration: UnmanagedCode

FileIOPermission
возможность поиска путей к каталогам и считывания их содержимого.for the ability to search directory paths and read their contents. Связанные перечисления: PathDiscovery и ReadAssociated enumerations: PathDiscovery and Read

ReflectionPermission
для доступа к закрытым типам и членам независимо от набора их разрешений.for accessing nonpublic types and members regardless of their grant set. Связанное перечисление: MemberAccessAssociated enumeration: MemberAccess

Применяется к